.Net Core in Action

**Summary** __.NET Core in Action__ shows .NET developers how to build professional software applications with .NET Core. Learn how to convert existing .NET code to work on multiple platforms or how to start new projects with knowledge of the tools and capabilities of .NET Core. **About the Technology** .NET Core is an open source framework that lets you write and run .NET applications on Linux and Mac, without giving up on Windows. Built for everything from lightweight web apps to industrial-strength distributed systems, it's perfect for deploying .NET servers to any cloud platform, including AWS and GCP. **About the Book** __.NET Core in Action__ introduces you to cross-platform development with .NET Core. This hands-on guide concentrates on new Core features as you walk through familiar tasks like testing, logging, data access, and networking. As you go, you'll explore modern architectures like microservices and cloud data storage, along with practical matters like performance profi ling, localization, and signing assemblies. **What's inside** - Choosing the right tools - Testing, profiling, and debugging - Interacting with web services - Converting existing projects to .NET Core - Creating and using NuGet packages **About the Reader** All examples are in C#. **About the Author** Dustin Metzgar is a seasoned developer and architect involved in numerous .NET Core projects. Dustin works for Microsoft. .NET Core in Action 1 contents 5 foreword 11 preface 12 acknowledgments 14 about this book 15 Who should read this book 15 How this book is organized: a roadmap 15 About the code 16 Book forum 16 Online resources 17 about the author 18 about the cover illustration 19 1 Why .NET Core? 21 1.1 Architecting enterprise applications before .NET Core 22 1.2 If you’re a .NET Framework developer 23 1.2.1 Your .NET apps can be cross-platform 23 1.2.2 ASP.NET Core outperforms ASP.NET in the .NET Framework 23 1.2.3 .NET Core is the focus for innovation 24 1.2.4 Release cycles are faster 24 1.3 If you are new to .NET 24 1.3.1 C# is an amazing language 25 1.3.2 .NET Core is not starting from scratch 25 1.3.3 Focus on performance 25 1.4 What is .NET Core? 25 1.5 Key .NET Core features 26 1.5.1 Expanding the reach of your libraries 26 1.5.2 Simple deployment on any platform 27 1.5.3 Clouds and containers 28 1.5.4 ASP.NET performance 29 1.5.5 Open source 30 1.5.6 Bring your own tools 31 1.6 Applying .NET Core to real-world applications 31 1.7 Differences from the .NET Framework 32 1.7.1 Framework features not ported to Core 32 1.7.2 Subtle changes for .NET Framework developers 32 1.7.3 Changes to .NET reflection 33 Additional resources 33 Summary 34 2 Building your first .NET Core applications 35 2.1 The trouble with development environments 35 2.2 Installing the .NET Core SDK 36 2.2.1 Installing on Windows operating systems 36 2.2.2 Installing on Linux-based operating systems 36 2.2.3 Installing on macOS 36 2.2.4 Building .NET Core Docker containers 37 2.3 Creating and running the Hello World console application 37 2.3.1 Before you build 38 2.3.2 Running a .NET Core application 38 2.4 Creating an ASP.NET Core web application 38 2.4.1 ASP.NET Core uses the Kestrel web server 39 2.4.2 Using a Startup class to initialize the web server 40 2.4.3 Running the Hello World web application 41 2.5 Creating an ASP.NET Core website from the template 42 2.6 Deploying to a server 42 2.6.1 Publishing an application 43 2.6.2 Deploying to a Docker container 45 2.6.3 Packaging for distribution 46 2.7 Development tools available for .NET Core 47 2.7.1 OmniSharp 47 2.7.2 Visual Studio for Mac 48 2.7.3 Visual Studio 2017 48 Additional resources 50 Summary 51 3 How to build with .NET Core 52 3.1 Key concepts in .NET Core’s build system 52 3.1.1 Introducing MSBuild 53 3.1.2 Creating .NET projects from the command line 53 3.1.3 Clearing up the terminology 53 3.2 CSV parser sample project 56 3.3 Introducing MSBuild 59 3.3.1 PropertyGroups 59 3.3.2 Targets 60 3.3.3 ItemGroups 61 3.4 Dependencies 64 3.5 Targeting multiple frameworks 65 Additional resources 66 Summary 66 4 Unit testing with xUnit 68 4.1 Why write unit tests? 68 4.2 Business-day calculator example 69 4.3 xUnit—a .NET Core unit-testing framework 71 4.4 Setting up the xUnit test project 72 4.5 Evaluating truth with xUnit facts 72 4.6 Running tests from development environments 74 4.7 When it’s impossible to prove all cases, use a theory 75 4.8 Shared context between tests 77 4.8.1 Using the constructor for setup 77 4.8.2 Using Dispose for cleanup 80 4.8.3 Sharing context with class fixtures 82 4.8.4 Sharing context with collection fixtures 83 4.9 Getting output from xUnit tests 85 4.10 Traits 86 Additional resources 87 Summary 87 5 Working with relational databases 89 5.1 Using SQLite for prototyping 90 5.2 Planning the application and database schema 92 5.2.1 Tracking inventory 92 5.2.2 Creating tables in SQLite 93 5.3 Creating a data-access library 96 5.3.1 Specifying relationships in data and code 100 5.3.2 Updating data 104 5.3.3 Managing inventory 109 5.3.4 Using transactions for consistency 111 5.4 Ordering new parts from suppliers 113 5.4.1 Creating an Order 114 5.4.2 Checking if parts need to be ordered 119 Additional resources 122 Summary 122 6 Simplify data access with object-relational mappers 124 6.1 Dapper 125 6.1.1 Inserting rows with Dapper 128 6.1.2 Applying transactions to Dapper commands 129 6.1.3 The drawback of a micro-ORM 130 6.1.4 A brief introduction to dependency injection 132 6.1.5 Dependency injection in .NET Core 134 6.1.6 Configuring the application 142 6.1.7 When to build your own data-access layer 146 6.2 Entity Framework Core 147 6.2.1 Using EF migrations to create the database 149 6.2.2 Running the tests using EF 150 Additional resources 152 Summary 152 7 Creating a microservice 154 7.1 Writing an ASP.NET web service 155 7.1.1 Converting Markdown to HTML 155 7.1.2 Creating an ASP.NET web service 156 7.1.3 Testing the web service with Curl 159 7.2 Making HTTP calls 159 7.3 Making the service asynchronous 161 7.4 Getting data from Azure Blob Storage 162 7.4.1 Getting values from configuration 162 7.4.2 Creating the GetBlob method 164 7.4.3 Testing the new Azure storage operation 167 7.5 Uploading and receiving uploaded data 168 7.6 Listing containers and BLOBs 170 7.7 Deleting a BLOB 172 Additional resources 173 Summary 173 8 Debugging 175 8.1 Debugging applications with Visual Studio Code 176 8.1.1 Using the .NET Core debugger 178 8.2 Debugging with Visual Studio 2017 180 8.3 Debugging with Visual Studio for Mac 182 8.4 SOS 183 8.4.1 Easier to get started with a self-contained app 184 8.4.2 WinDBG/CDB 186 8.4.3 LLDB 190 Additional resources 191 Summary 192 9 Performance and profiling 193 9.1 Creating a test application 194 9.2 xUnit.Performance makes it easy to run performance tests 197 9.3 Using PerfView on .NET Core applications 204 9.3.1 Getting a CPU profile 204 9.3.2 Analyzing a CPU profile 207 9.3.3 Looking at GC information 211 9.3.4 Exposing exceptions 212 9.3.5 Collecting performance data on Linux 214 Additional resources 215 Summary 215 10 Building world-ready applications 216 10.1 Going international 217 10.1.1 Setting up the sample application 217 10.1.2 Making the sample application world-ready 218 10.2 Using a logging framework instead of writing to the console 222 10.2.1 Using the Microsoft .Extensions.Logging library 224 10.2.2 Internationalization 227 10.2.3 Globalization 227 10.2.4 Localizability review 228 10.3 Using the Microsoft localization extensions library 229 10.3.1 Testing right-to-left languages 231 10.3.2 Invariant culture 233 10.3.3 Using EventSource to emit events 234 10.3.4 Using EventListener to listen for events 236 10.4 Other considerations for globalization 239 10.5 Localization 239 Additional resources 240 Summary 240 11 Multiple frameworks and runtimes 242 11.1 Why does the .NET Core SDK support multiple frameworks and runtimes? 242 11.2 .NET Portability Analyzer 244 11.2.1 Installing and configuring the Visual Studio 2017 plugin 244 11.2.2 Sample .NET Framework project 245 11.2.3 Running the Portability Analyzer in Visual Studio 246 11.3 Supporting multiple frameworks 250 11.3.1 Using EventSource to replace EventProvider 250 11.3.2 Adding another framework to the project 253 11.3.3 Creating a NuGet package and checking the contents 255 11.3.4 Per-framework build options 255 11.4 Runtime-specific code 258 Additional resources 260 Summary 260 12 Preparing for release 262 12.1 Preparing a NuGet package 262 12.1.1 How to handle project references 264 12.1.2 NuGet feeds 267 12.1.3 Packaging resource assemblies 268 12.2 Signing assemblies 269 12.2.1 Generating a signing key 270 12.2.2 Delay-signing 270 12.2.3 Signing an assembly in .NET Core 271 Additional resources 271 Summary 271 appendix A Frameworks and runtimes 273 appendix B xUnit command-line options 275 appendix C What’s in the .NET Standard Library? 277 netstandard 1.0 277 netstandard 1.1 277 netstandard 1.2 278 netstandard 1.3 278 netstandard 1.4 278 netstandard 1.5 278 netstandard 1.6 278 netstandard 2.0 278 appendix D NuGet cache locations 280 index 281 Symbols 281 A 281 B 282 C 282 D 282 E 283 F 284 G 284 H 284 I 284 J 284 K 284 L 285 M 285 N 285 O 286 P 286 R 287 S 287 T 287 U 288 V 288 W 288 X 288 .NET Core in Action - back 289 Summary.NET Core in Action shows.NET developers how to build professional software applications with.NET Core. Learn how to convert existing.NET code to work on multiple platforms or how to start new projects with knowledge of the tools and capabilities of.NET Core. Purchase of the print book includes a free eBook in PDF, Kindle, and ePub formats from Manning Publications. About the Technology.NET Core is an open source framework that lets you write and run.NET applications on Linux and Mac, without giving up on Windows. Built for everything from lightweight web apps to industrial-strength distributed systems, it's perfect for deploying.NET servers to any cloud platform, including AWS and GCP. About the Book.NET Core in Action introduces you to cross-platform development with.NET Core. This hands-on guide concentrates on new Core features as you walk through familiar tasks like testing, logging, data access, and networking. As you go, you'll explore modern architectures like microservices and cloud data storage, along with practical matters like performance profi ling, localization, and signing assemblies. What's Inside Choosing the right tools Testing, profiling, and debugging Interacting with web services Converting existing projects to.NET Core Creating and using NuGet packages About the Reader All examples are in C#. About the Author Dustin Metzgar is a seasoned developer and architect involved in numerous.NET Core projects. Dustin works for Microsoft. Table of Contents Why.NET Core? Building your first.NET Core applications How to build with.NET Core Unit testing with xUnit Working with relational databases Simplify data access with object-relational mappers Creating a microservice Debugging Performance and profiling Building world-ready applications Multiple frameworks and runtimes Preparing for release appendix A - Frameworks and runtimes appendix B - xUnit command-line options appendix C - What's in the.NET Standard Library? appendix D - NuGet cache locations Summary .NET Core in Action shows .NET developers how to build professional software applications with .NET Core. Learn how to convert existing .NET code to work on multiple platforms or how to start new projects with knowledge of the tools and capabilities of .NET Core. Purchase of the print book includes a free eBook in PDF, Kindle, and ePub formats from Manning Publications. About the Technology .NET Core is an open source framework that lets you write and run .NET applications on Linux and Mac, without giving up on Windows. Built for everything from lightweight web apps to industrial-strength distributed systems, it's perfect for deploying .NET servers to any cloud platform, including AWS and GCP. About the Book .NET Core in Action introduces you to cross-platform development with .NET Core. This hands-on guide concentrates on new Core features as you walk through familiar tasks like testing, logging, data access, and networking. As you go, you'll explore modern architectures like microservices and cloud data storage, along with practical matters like performance profi ling, localization, and signing assemblies. What's Inside About the Reader All examples are in C#. About the Author Dustin Metzgar is a seasoned developer and architect involved in numerous .NET Core projects. Dustin works for Microsoft. Table of Contents .NET Core is a subset of the .NET framework with libraries and runtimes that drastically reduce its footprint, so you can write and run .NET applications more efficiently..NET Core in Action shows .NET developers how to build professional software applications with .NET Core. By the end of this book, readers will be able to convert existing .NET code to work on multiple platforms or start new projects with knowledge of the tools and capabilities of .NET Core.what's inside* Choosing the right tools* Testing, profiling, and debugging* Interacting with web services* Converting existing projects to .NET Core* Creating and using NuGet packages .net Core Is A Subset Of The .net Framework With Libraries And Runtimes That Drastically Reduce Its Footprint, So You Can Write And Run .net Applications More Efficiently. .net Core In Action Shows .net Developers How To Build Professional Software Applications With .net Core. By The End Of This Book, Readers Will Be Able To Convert Existing .net Code To Work On Multiple Platforms Or Start New Projects With Knowledge Of The Tools And Capabilities Of .net Core. Purchase Of The Print Book Includes A Free Ebook In Pdf, Kindle, And Epub Formats From Manning Publications.