========================
CODE SNIPPETS
========================
TITLE: Entity Framework Getting Started and Quickstart
DESCRIPTION: Provides guidance on quickly setting up and using the Entity Framework, including a Quickstart example for creating a basic Entity Framework application.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/framework/data/adonet/ef/overview.md#_snippet_8

LANGUAGE: dotnet
CODE:
```
[Getting Started](getting-started.md) - Provides information about how to get up and running quickly using the [Quickstart](/previous-versions/dotnet/netframework-4.0/bb399182(v=vs.100)), which shows how to create a simple Entity Framework application.
```

----------------------------------------

TITLE: F# Getting Started Guides
DESCRIPTION: Provides links to guides for installing and using F# on different operating systems (Windows, macOS, Linux) with various IDEs (Visual Studio, VS Code) and the command line (.NET CLI).

SOURCE: https://github.com/dotnet/docs/blob/main/docs/fsharp/get-started/index.md#_snippet_0

LANGUAGE: Markdown
CODE:
```
| OS      | Prefer Visual Studio                                           | Prefer Visual Studio Code                                    | Prefer command line                                         |
| ------- |----------------------------------------------------------------|--------------------------------------------------------------|--------------------------------------------------------------|
| Windows | [Get started with Visual Studio](get-started-visual-studio.md) | [Get started with Visual Studio Code](get-started-vscode.md) | [Get started with the .NET CLI](get-started-command-line.md) |
| macOS   | N/A                                                            | [Get started with Visual Studio Code](get-started-vscode.md) | [Get started with the .NET CLI](get-started-command-line.md) |
| Linux   | N/A                                                            | [Get started with Visual Studio Code](get-started-vscode.md) | [Get started with the .NET CLI](get-started-command-line.md) |
```

----------------------------------------

TITLE: F# Online Getting Started Options
DESCRIPTION: Lists online resources for getting started with F# without local installation, including a Jupyter notebook on Binder and the Fable REPL for in-browser code execution and translation.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/fsharp/get-started/index.md#_snippet_1

LANGUAGE: Markdown
CODE:
```
* [Introduction to F# on Binder](https://mybinder.org/v2/gh/dotnet/interactive/main?urlpath=lab) is a [Jupyter notebook](https://jupyter.org/) hosted via the free [Binder](https://mybinder.org/) service. No sign-up needed!
* [The Fable REPL](https://fable.io/repl/) is an interactive, in-browser REPL that uses [Fable](https://fable.io/) to translate F# code into JavaScript. Check out the numerous samples that range from F# basics to a fully fledged video game all executing in your browser!
```

----------------------------------------

TITLE: Install System.CommandLine Package
DESCRIPTION: Installs the System.CommandLine package, which is necessary for building command-line applications. The `--prerelease` option is required as the library is in beta.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/standard/commandline/get-started-tutorial.md#_snippet_0

LANGUAGE: dotnetcli
CODE:
```
dotnet add package System.CommandLine --prerelease
```

LANGUAGE: dotnetcli
CODE:
```
dotnet package add System.CommandLine --prerelease
```

----------------------------------------

TITLE: Help Output Example
DESCRIPTION: Illustrates the command to display help information and the expected output when using the `--help` option.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/standard/commandline/get-started-tutorial.md#_snippet_9

LANGUAGE: console
CODE:
```
scl --help
```

LANGUAGE: output
CODE:
```
Description:
  Sample app for System.CommandLine

Usage:
  scl [options]

Options:
  -?, -h, --help  Show help and usage information
  --version       Show version information
  --file          The file to read and display on the conso
```

----------------------------------------

TITLE: WCF Getting Started Tutorial
DESCRIPTION: A tutorial that guides users through the fundamental steps of creating a WCF service and its corresponding client. Ideal for those new to WCF development.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/framework/wcf/guide-to-the-documentation.md#_snippet_11

LANGUAGE: dotnet
CODE:
```
Getting Started Tutorial
  getting-started-tutorial.md
    - Tutorial for creating a basic WCF service and client.
```

----------------------------------------

TITLE: Build a Hello World application with .NET Core in Visual Studio
DESCRIPTION: This tutorial guides you through building a basic "Hello World" application using .NET Core within Visual Studio. It covers the initial setup and fundamental steps for .NET Core development.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/visual-basic/getting-started/index.md#_snippet_0

LANGUAGE: visualbasic
CODE:
```
[Build a Hello World application with .NET Core in Visual Studio](../../core/tutorials/with-visual-studio.md)
```

----------------------------------------

TITLE: Program.cs Contents
DESCRIPTION: Specifies the full content of the Program.cs file, including the setup of the command-line interface and the action to be invoked.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/standard/commandline/get-started-tutorial.md#_snippet_6

LANGUAGE: csharp
CODE:
```
using System;
using System.CommandLine;
using System.CommandLine.Parsing;

var rootCommand = new RootCommand("Sample app for System.CommandLine");

var fileOption = new Option<string>(
    "--file",
    "The file to read and display on the console.");

rootCommand.AddOption(fileOption);

rootCommand.SetAction(ReadFile);

return await rootCommand.InvokeAsync(args);

void ReadFile(ParseResult parseResult)
{
    var filePath = parseResult.GetValueForOption(fileOption);
    if (string.IsNullOrEmpty(filePath))
    {
        Console.WriteLine("No file specified.");
        return;
    }

    try
    {
        var content = System.IO.File.ReadAllText(filePath);
        Console.WriteLine(content);
    }
    catch (System.IO.FileNotFoundException)
    {
        Console.WriteLine($"File not found: {filePath}");
    }
    catch (System.Exception ex)
    {
        Console.WriteLine($"An error occurred: {ex.Message}");
    }
}
```

----------------------------------------

TITLE: Install and Use NuGet Package with CLI
DESCRIPTION: Quickstart guide for installing and using a NuGet package using the .NET CLI.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/core/tutorials/index.md#_snippet_13

LANGUAGE: cli
CODE:
```
Install and use a package (/nuget/quickstart/install-and-use-a-package-using-the-dotnet-cli)
```

----------------------------------------

TITLE: Run Sense HAT Quickstart Script
DESCRIPTION: Downloads and executes a script that installs the .NET SDK, clones the Sense HAT quickstart project from GitHub, builds it, and runs it. This script automates the setup and execution of the quickstart project.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/iot/quickstarts/sensehat.md#_snippet_1

LANGUAGE: bash
CODE:
```
. <(wget -q -O - https://aka.ms/dotnet-iot-sensehat-quickstart)
```

----------------------------------------

TITLE: Getting Started with .NET
DESCRIPTION: Provides a link to the primary guide for starting .NET application development. This is the entry point for new developers to understand the .NET ecosystem and begin building applications.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/welcome.md#_snippet_0

LANGUAGE: markdown
CODE:
```
[Get started with .NET](core/get-started.md)
```

----------------------------------------

TITLE: Install and Use NuGet Package with Visual Studio
DESCRIPTION: Quickstart guide for installing and using a NuGet package in Visual Studio.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/core/tutorials/index.md#_snippet_5

LANGUAGE: nuget
CODE:
```
Install and use a package (/nuget/quickstart/install-and-use-a-package-in-visual-studio)
```

----------------------------------------

TITLE: Example CLI Usage and Output
DESCRIPTION: Demonstrates how to invoke the CLI application with different commands and options, showcasing the expected output for various scenarios, including error handling for non-existent files and help messages for subcommands.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/standard/commandline/get-started-tutorial.md#_snippet_33

LANGUAGE: console
CODE:
```
scl quotes read --file sampleQuotes.txt --delay 40 --fgcolor red --light-mode
scl quotes add "Hello world!" "Nancy Davolio"
scl quotes delete --search-terms David "You can do" Antoine "Perfection is achieved"

scl quotes read --file nofile
// Expected output:
// File does not exist

scl quotes
// Expected output:
// Required command was not provided.
//
// Description:
//   Work with a file that contains quotes.
//
// Usage:
//   scl quotes [command] [options]
//
// Options:
//   --file <file>   An option whose argument is parsed as a FileInfo [default: sampleQuotes.txt]
//   -?, -h, --help  Show help and usage information
//
// Commands:
//   read                          Read and display the file.
//   delete                        Delete lines from the file.
//   add, insert <quote> <byline>  Add an entry to the file.
```

----------------------------------------

TITLE: Get started with Entity Framework 6
DESCRIPTION: This section provides guidance on quickly starting to use the latest version of the Entity Framework. It links to external resources for detailed instructions.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/framework/data/adonet/ef/getting-started.md#_snippet_0

LANGUAGE: dotnet
CODE:
```
To quickly start using the latest version of the Entity Entity Framework, see [Get started with Entity Framework 6](/ef/ef6/get-started).
```

----------------------------------------

TITLE: Project Setup and Deployment Guidance
DESCRIPTION: This section provides guidance on setting up the project and its prerequisites for deployment. It emphasizes the availability of a development container with all necessary dependencies and lists the essential requirements for users, including an Azure subscription, appropriate Azure account permissions, and a GitHub account.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/ai/get-started-app-chat-template.md#_snippet_2

LANGUAGE: APIDOC
CODE:
```
ProjectSetup:
  DevelopmentEnvironment:
    Option: Development Container (recommended)
    Availability: GitHub Codespaces (browser), Visual Studio Code (local).
    Includes: All dependencies.
  Prerequisites:
    AzureSubscription:
      Requirement: Active Azure subscription.
      Action: Create one for free.
    AzureAccountPermissions:
      RequiredRoles: Microsoft.Authorization/roleAssignments/write (e.g., User Access Administrator, Owner).
    GitHubAccount:
      Requirement: GitHub account.
```

----------------------------------------

TITLE: MCP C# SDK Integration Example
DESCRIPTION: Illustrates how to integrate the MCP C# SDK within a .NET application. This example assumes basic setup and focuses on the client/server interaction pattern facilitated by the SDK.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/ai/get-started-mcp.md#_snippet_3

LANGUAGE: csharp
CODE:
```
// Example of creating an MCP client
var client = new McpClient();

// Example of creating an MCP server
var server = new McpServer();

// Further integration with AI models and tools would follow...
```

----------------------------------------

TITLE: Get started with Visual Basic
DESCRIPTION: Resources for learning the Visual Basic programming language.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/standard/get-started.md#_snippet_13

LANGUAGE: vbnet
CODE:
```
Imports System

Module HelloWorld
    Sub Main()
        Console.WriteLine("Hello, Visual Basic!")
    End Sub
End Module
```

----------------------------------------

TITLE: Deployment Guide for Developers
DESCRIPTION: Explains how developers can install the .NET Framework on their users' computers alongside their applications. This guide focuses on embedding the .NET Framework installer within the application's setup process.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/framework/deployment/deploying-the-net-framework.md#_snippet_0

LANGUAGE: dotnet
CODE:
```
This section of the .NET Framework documentation provides information for developers who want to install the .NET Framework with their applications.
```

----------------------------------------

TITLE: .NET Get Started and Resources
DESCRIPTION: Provides a comprehensive overview of the .NET Framework and links to additional resources for learning and development.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/framework/development-guide.md#_snippet_16

LANGUAGE: APIDOC
CODE:
```
Get Started:
  Resources for new users to begin developing with the .NET Framework.
  Includes tutorials, conceptual overviews, and links to essential documentation.
  Focuses on setting up the development environment and writing first applications.
```

----------------------------------------

TITLE: MCP Server Response Example
DESCRIPTION: Example output from the MCP server after executing a tool via GitHub Copilot.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/ai/quickstarts/build-mcp-server.md#_snippet_6

LANGUAGE: output
CODE:
```
Your random number is 42.
```

----------------------------------------

TITLE: Install .NET Compiler Platform SDK
DESCRIPTION: Instructions for installing the .NET Compiler Platform SDK, which is necessary for working with semantic analysis in .NET.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/csharp/roslyn-sdk/get-started/semantic-analysis.md#_snippet_0

LANGUAGE: bash
CODE:
```
[!INCLUDE[interactive-note](~/includes/roslyn-installation.md)]
```

----------------------------------------

TITLE: Get started with F#
DESCRIPTION: Resources for learning the F# programming language.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/standard/get-started.md#_snippet_12

LANGUAGE: fsharp
CODE:
```
printfn "Hello, F#!";;
```

----------------------------------------

TITLE: Chaining .NET Framework Language Packs with Offline Installer
DESCRIPTION: This example shows how to use the command line to install a .NET Framework offline installer along with a specific language pack. The `/q` flag enables quiet installation, `/norestart` prevents automatic restarts, and `/ChainingPackage` specifies the product name.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/framework/deployment/deployment-guide-for-developers.md#_snippet_14

LANGUAGE: bash
CODE:
```
NDP451-KB2858728-x86-x64-AllOS-JPN.exe /q /norestart /ChainingPackage <ProductName>
```

----------------------------------------

TITLE: Get started with C#
DESCRIPTION: Resources for learning the C# programming language.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/standard/get-started.md#_snippet_11

LANGUAGE: csharp
CODE:
```
using System;

public class HelloWorld
{
    public static void Main(string[] args)
    {
        Console.WriteLine("Hello, C#!");
    }
}
```

----------------------------------------

TITLE: Install MSTest using MSTest meta-package
DESCRIPTION: This snippet demonstrates installing the MSTest meta-package, which bundles MSTest.TestFramework, MSTest.TestAdapter, MSTest.Analyzers, and Microsoft.NET.Test.Sdk. This is an alternative to using the MSTest.Sdk.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/core/testing/unit-testing-mstest-getting-started.md#_snippet_1

LANGUAGE: xml
CODE:
```
<PackageReference Include="MSTest" Version="X.Y.Z" />
```

----------------------------------------

TITLE: Install MCP Server Template
DESCRIPTION: Installs the .NET template for creating MCP servers. Ensure you have .NET 10.0 SDK (preview 6 or higher) installed.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/ai/quickstarts/build-mcp-server.md#_snippet_0

LANGUAGE: bash
CODE:
```
dotnet new install Microsoft.Extensions.AI.Templates
```

----------------------------------------

TITLE: Launch Method for Installation
DESCRIPTION: The Launch method constructs the command line for the setup executable and uses `CreateProcess` to launch it. It then calls the `Run` method from the base class to monitor the installation progress via an `IProgressObserver`.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/framework/deployment/how-to-get-progress-from-the-dotnet-installer.md#_snippet_8

LANGUAGE: cpp
CODE:
```
bool Launch(const CString& args)
{
    CString cmdline = L"dotNetFx45_Full_x86_x64.exe -pipe TheSectionName " + args; // Customize with name and location of setup .exe that you want to run
    STARTUPINFO si = {0};
    si.cb = sizeof(si);
    PROCESS_INFORMATION pi = {0};

    // Launch the Setup.exe that installs the .NET Framework 4.5
    BOOL bLaunchedSetup = ::CreateProcess(NULL,
     cmdline.GetBuffer(),
     NULL, NULL, FALSE, 0, NULL, NULL,
     &si,
     &pi);

    // If successful
    if (bLaunchedSetup != 0)
    {
    IProgressObserver& observer = dynamic_cast<IProgressObserver&>(*this);
    Run(pi.hProcess, observer);

    ……………………..
    return (bLaunchedSetup != 0);
    }
}
```

----------------------------------------

TITLE: ML.NET CLI Help Output Example
DESCRIPTION: Example output shown after a successful installation or when running the 'mlnet' command, indicating the tool is ready for use and listing available commands.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/machine-learning/how-to-guides/install-ml-net-cli.md#_snippet_23

LANGUAGE: console
CODE:
```
You can invoke the tool using the following command: mlnet
Tool 'mlnet-<OS>-<ARCH>' (version 'X.X.X') was successfully installed.
```

----------------------------------------

TITLE: Table Setup for Bulk Copy Examples
DESCRIPTION: This Transact-SQL script creates and configures tables required for demonstrating SqlBulkCopy operations. It includes setup for matching columns, different columns, and order header/detail tables based on the AdventureWorks database schema.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/framework/data/adonet/sql/bulk-copy-example-setup.md#_snippet_0

LANGUAGE: sql
CODE:
```
USE AdventureWorks  

IF EXISTS (SELECT * FROM dbo.sysobjects
 WHERE id = object_id(N'[dbo].[BulkCopyDemoMatchingColumns]')  
 AND OBJECTPROPERTY(id, N'IsUserTable') = 1)
    DROP TABLE [dbo].[BulkCopyDemoMatchingColumns]

CREATE TABLE [dbo].[BulkCopyDemoMatchingColumns]([ProductID] [int] IDENTITY(1,1) NOT NULL,
    [Name] [nvarchar](50) NOT NULL,
    [ProductNumber] [nvarchar](25) NOT NULL,
 CONSTRAINT [PK_ProductID] PRIMARY KEY CLUSTERED  
(
    [ProductID] ASC
) ON [PRIMARY]) ON [PRIMARY]

IF EXISTS (SELECT * FROM dbo.sysobjects
 WHERE id = object_id(N'[dbo].[BulkCopyDemoDifferentColumns]')  
 AND OBJECTPROPERTY(id, N'IsUserTable') = 1)
    DROP TABLE [dbo].[BulkCopyDemoDifferentColumns]

CREATE TABLE [dbo].[BulkCopyDemoDifferentColumns]([ProdID] [int] IDENTITY(1,1) NOT NULL,
    [ProdNum] [nvarchar](25) NOT NULL,
    [ProdName] [nvarchar](50) NOT NULL,
 CONSTRAINT [PK_ProdID] PRIMARY KEY CLUSTERED  
(
    [ProdID] ASC
) ON [PRIMARY]) ON [PRIMARY]

IF EXISTS (SELECT * FROM dbo.sysobjects
 WHERE id = object_id(N'[dbo].[BulkCopyDemoOrderHeader]')  
 AND OBJECTPROPERTY(id, N'IsUserTable') = 1)
    DROP TABLE [dbo].[BulkCopyDemoOrderHeader]

CREATE TABLE [dbo].[BulkCopyDemoOrderHeader]([SalesOrderID] [int] IDENTITY(1,1) NOT NULL,
    [OrderDate] [datetime] NOT NULL,
    [AccountNumber] [nvarchar](15) NULL,
 CONSTRAINT [PK_SalesOrderID] PRIMARY KEY CLUSTERED  
(
    [SalesOrderID] ASC
) ON [PRIMARY]) ON [PRIMARY]

IF EXISTS (SELECT * FROM dbo.sysobjects
 WHERE id = object_id(N'[dbo].[BulkCopyDemoOrderDetail]')  
 AND OBJECTPROPERTY(id, N'IsUserTable') = 1)
    DROP TABLE [dbo].[BulkCopyDemoOrderDetail]

CREATE TABLE [dbo].[BulkCopyDemoOrderDetail]([SalesOrderID] [int] NOT NULL,
    [SalesOrderDetailID] [int] NOT NULL,
    [OrderQty] [smallint] NOT NULL,
    [ProductID] [int] NOT NULL,
    [UnitPrice] [money] NOT NULL,
 CONSTRAINT [PK_LineNumber] PRIMARY KEY CLUSTERED  
(
    [SalesOrderID] ASC,
    [SalesOrderDetailID] ASC
) ON [PRIMARY]) ON [PRIMARY]
```

----------------------------------------

TITLE: Running Setup Script
DESCRIPTION: Executes the setup script for the sample. This script installs necessary service certificates for running the sample. It requires administrator privileges.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/framework/wcf/samples/membership-and-role-provider.md#_snippet_2

LANGUAGE: bash
CODE:
```
Setup.bat service
```

----------------------------------------

TITLE: Example: Installing .NET Runtime 5.0.15 (Bash)
DESCRIPTION: This Bash command provides a concrete example of using `dotnet-install.sh` to install the .NET 5.0.15 runtime for x64 architecture into the default `/usr/share/dotnet/` directory on Linux. This helps resolve 'Required framework not found' errors.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/core/runtime-discovery/troubleshoot-app-launch.md#_snippet_10

LANGUAGE: bash
CODE:
```
./dotnet-install.sh --architecture x64 --install-dir /usr/share/dotnet/ --runtime dotnet --version 5.0.15
```

----------------------------------------

TITLE: Quickstart: Use .NET to create a blob in object storage
DESCRIPTION: A quickstart guide for .NET developers to create a blob in Azure Blob storage. It covers setting up the environment, writing code to interact with Blob storage, and performing basic operations like uploading a file.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/fsharp/using-fsharp-on-azure/blob-storage.md#_snippet_20

LANGUAGE: APIDOC
CODE:
```
Quickstart: Create Blob with .NET:
  URL: https://learn.microsoft.com/en-us/azure/storage/blobs/storage-quickstart-blobs-dotnet
  Description: This quickstart guide walks you through the process of creating and managing blobs in Azure Blob Storage using the Azure Storage Blob client library for .NET. It covers prerequisites, setting up a storage account, writing C# code to upload a text file as a blob, and downloading it. This is an essential resource for .NET developers beginning with Azure Blob Storage.
```

----------------------------------------

TITLE: Configure sampleQuotes.txt Copy
DESCRIPTION: This XML snippet configures the build process to copy the `sampleQuotes.txt` file to the output directory. This ensures the file is available when the application runs, allowing it to be accessed by name without a path.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/standard/commandline/get-started-tutorial.md#_snippet_11

LANGUAGE: xml
CODE:
```
<ItemGroup>
  <Content Include="sampleQuotes.txt">
    <CopyToOutputDirectory>Always</CopyToOutputDirectory>
  </Content>
</ItemGroup>
```

----------------------------------------

TITLE: Error Handling Example
DESCRIPTION: Demonstrates how the system handles invalid arguments by printing error messages to standard error and help to standard output, returning an exit code of 1.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/standard/commandline/get-started-tutorial.md#_snippet_10

LANGUAGE: console
CODE:
```
scl --invalid bla
```

LANGUAGE: output
CODE:
```
Unrecognized command or argument '--invalid'.
Unrecognized command or argument 'bla'.
```

----------------------------------------

TITLE: Examples of .NET Package Installation Commands
DESCRIPTION: Provides examples of commands to install specific .NET runtimes and SDKs using the package manager. These examples demonstrate the correct usage of the package naming convention.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/core/install/includes/package-manager-heading-hack-pkgname.md#_snippet_1

LANGUAGE: bash
CODE:
```
# Install the ASP.NET Core 9.0 runtime:
aspnetcore-runtime-9.0

# Install the .NET Core 2.1 runtime:
dotnet-runtime-2.1

# Install the .NET 5 SDK:
dotnet-sdk-5.0

# Install the .NET Core 3.1 SDK:
dotnet-sdk-3.1
```

----------------------------------------

TITLE: Install Microsoft.Data.Analysis NuGet Package
DESCRIPTION: Installs the Microsoft.Data.Analysis NuGet package, which provides the DataFrame functionality. This is the primary step to start using DataFrames in your .NET project.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/machine-learning/how-to-guides/getting-started-dataframe.md#_snippet_0

LANGUAGE: dotnetcli
CODE:
```
dotnet add package Microsoft.Data.Analysis
```

LANGUAGE: dotnetcli
CODE:
```
dotnet package add Microsoft.Data.Analysis
```

----------------------------------------

TITLE: Implicit Subscription Setup (Orleans 7.0+)
DESCRIPTION: Configures a grain to implicitly subscribe to a stream in Orleans 7.0+. It retrieves a stream provider, gets a stream reference using a GUID and namespace, and sets up an asynchronous callback to process incoming data.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/orleans/streaming/streams-quick-start.md#_snippet_9

LANGUAGE: csharp
CODE:
```
// Create a GUID based on our GUID as a grain
var guid = this.GetPrimaryKey();

// Get one of the providers which we defined in config
var streamProvider = GetStreamProvider("StreamProvider");

// Get the reference to a stream
var streamId = StreamId.Create("RANDOMDATA", guid);
var stream = streamProvider.GetStream<int>(streamId);

// Set our OnNext method to the lambda which simply prints the data.
// This doesn't make new subscriptions, because we are using implicit
// subscriptions via [ImplicitStreamSubscription].
await stream.SubscribeAsync<int>(
    async (data, token) =>
    {
        Console.WriteLine(data);
        await Task.CompletedTask;
    });

```

----------------------------------------

TITLE: Detailed Help for 'read' Subcommand
DESCRIPTION: The detailed help output for the 'read' subcommand, including options like --file, --delay, --fgcolor, and --light-mode.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/standard/commandline/get-started-tutorial.md#_snippet_20

LANGUAGE: output
CODE:
```
Description:
  Read and display the file.

Usage:
  scl read [options]

Options:
  --file <file>                                               The file to read and display on the console.
  --delay <delay>                                             Delay between lines, specified as milliseconds per
                                                              character in a line. [default: 42]
  --fgcolor                                                   Foreground color of text displayed on the console.
  <Black|Blue|Cyan|DarkBlue|DarkCyan|DarkGray|DarkGreen|Dark  [default: White]
Mage nta|DarkRed|DarkYellow|Gray|Green|Magenta|Red|White|Ye
llow>
  --light-mode                                                Background color of text displayed on the console:
default is black, light mode is white.
  -?, -h, --help                                              Show help and information
```

----------------------------------------

TITLE: Implicit Subscription Setup (Orleans 3.x)
DESCRIPTION: Configures a grain to implicitly subscribe to a stream in Orleans 3.x. It retrieves a stream provider, gets a stream reference using a GUID and stream name, and sets up an asynchronous callback to process incoming data.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/orleans/streaming/streams-quick-start.md#_snippet_10

LANGUAGE: csharp
CODE:
```
// Create a GUID based on our GUID as a grain
var guid = this.GetPrimaryKey();

// Get one of the providers which we defined in config
var streamProvider = GetStreamProvider("SMSProvider");

// Get the reference to a stream
var stream = streamProvider.GetStream<int>(guid, "RANDOMDATA");

// Set our OnNext method to the lambda which simply prints the data.
// This doesn't make new subscriptions, because we are using implicit
// subscriptions via [ImplicitStreamSubscription].
await stream.SubscribeAsync<int>(
    async (data, token) =>
    {
        Console.WriteLine(data);
        await Task.CompletedTask;
    });

```

----------------------------------------

TITLE: Executing 'read' with Color Options
DESCRIPTION: Shows how to set text colors using the --fgcolor and --light-mode options.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/standard/commandline/get-started-tutorial.md#_snippet_23

LANGUAGE: console
CODE:
```
scl read --file sampleQuotes.txt --fgcolor red --light-mode
```

----------------------------------------

TITLE: Get and Invoke Grain Method
DESCRIPTION: This example demonstrates how to import the Orleans PowerShell module, start the client, load a grain interface assembly, retrieve a specific grain reference using its type and GUID key, invoke a method on that grain, and then stop the client.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/orleans/host/powershell-client.md#_snippet_5

LANGUAGE: PowerShell
CODE:
```
Import-Module OrleansPSUtils
$configFilePath = Resolve-Path(".\ClientConfig.xml").Path
Start-GrainClient -ConfigFilePath $configFilePath
Add-Type -Path .\MyGrainInterfaceAssembly.dll
$grainInterfaceType = [MyInterfacesNamespace.IMyGrain]
$grainId = [System.Guid]::Parse("A4CF7B5D-9606-446D-ACE9-C900AC6BA3AD")
$grain = Get-Grain -GrainType $grainInterfaceType -GuidKey $grainId
$message = $grain.SayHelloTo("Gutemberg").Result
Write-Output $message
Stop-GrainClient
```

----------------------------------------

TITLE: Console Output Example
DESCRIPTION: Example console output showing the hierarchical listing of blobs in a container.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/fsharp/using-fsharp-on-azure/blob-storage.md#_snippet_15

LANGUAGE: console
CODE:
```
Directory: https://<accountname>.blob.core.windows.net/photos/2015/
Directory: https://<accountname>.blob.core.windows.net/photos/2016/
Block blob of length 505623: https://<accountname>.blob.core.windows.net/photos/photo1.jpg
```

----------------------------------------

TITLE: Install MSTest using MSTest.Sdk
DESCRIPTION: This snippet shows how to configure a .NET project to use the MSTest framework by referencing the MSTest.Sdk in the project file. This approach simplifies boilerplate configuration and includes all recommended MSTest packages.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/core/testing/unit-testing-mstest-getting-started.md#_snippet_0

LANGUAGE: xml
CODE:
```
<Project Sdk="MSTest.Sdk">
</Project>

<Project Sdk="MSTest.Sdk/X.Y.Z">
</Project>
```

----------------------------------------

TITLE: Getting Progress from the .NET Framework Installer
DESCRIPTION: Explains how to silently launch and monitor the .NET Framework setup process, allowing for custom progress indicators within an application. This is useful for providing a seamless user experience.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/framework/deployment/deploying-the-net-framework.md#_snippet_3

LANGUAGE: dotnet
CODE:
```
Describes how to silently launch and track the .NET Framework setup process while showing your own view of the setup progress.
```

----------------------------------------

TITLE: Configure and start a silo
DESCRIPTION: This snippet demonstrates how to configure and start an Orleans silo within an IHost. It relies on external configuration guides for detailed setup.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/orleans/deployment/index.md#_snippet_0

LANGUAGE: dotnet
CODE:
```
Configure the silo in conjunction with an <xref:Microsoft.Extensions.Hosting.IHost>. For more information, see [Orleans: Server configuration](../host/configuration-guide/server-configuration.md). After configuring the silo within the host, start the host to initiate the Orleans silo.
```

----------------------------------------

TITLE: Help Output for 'read' Subcommand
DESCRIPTION: Displays the help information for the 'read' subcommand, detailing its options and their descriptions.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/standard/commandline/get-started-tutorial.md#_snippet_19

LANGUAGE: console
CODE:
```
scl read -h
```

----------------------------------------

TITLE: Build and Run the Application
DESCRIPTION: Instructions on how to build the .NET console application and run it from the command line, including passing the `--file` option to specify a file for processing.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/standard/commandline/get-started-tutorial.md#_snippet_5

LANGUAGE: dotnetcli
CODE:
```
dotnet build
cd bin/Debug/net9.0
scl --file scl.runtimeconfig.json
```

LANGUAGE: dotnetcli
CODE:
```
dotnet run -- --file bin/Debug/net9.0/scl.runtimeconfig.json
```

----------------------------------------

TITLE: .NET CLI Output Example
DESCRIPTION: Example output when running the 'dotnet' command without arguments, showing usage instructions and available options.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/core/install/linux-snap-runtime.md#_snippet_7

LANGUAGE: output
CODE:
```
Usage: dotnet [options]
Usage: dotnet [path-to-application]

Options:
  -h|--help         Display help.
  --info            Display .NET information.
  --list-sdks       Display the installed SDKs.
  --list-runtimes   Display the installed runtimes.

path-to-application:
  The path to an application .dll file to execute.
```

----------------------------------------

TITLE: Example of installing .NET dependencies on Ubuntu
DESCRIPTION: An example command demonstrating how to install the required dependencies for running .NET applications on Ubuntu using the apt package manager.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/core/install/linux-ubuntu-decision.md#_snippet_24

LANGUAGE: bash
CODE:
```
sudo apt install ca-certificates libicu72 libssl3
```

----------------------------------------

TITLE: Create a Real-time Web App
DESCRIPTION: Tutorial for building .NET applications with real-time capabilities using SignalR.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/standard/get-started.md#_snippet_4

LANGUAGE: csharp
CODE:
```
public class ChatHub : Hub
{
    public async Task SendMessage(string user, string message)
    {
        await Clients.All.SendAsync("ReceiveMessage", user, message);
    }
}
```

----------------------------------------

TITLE: Get started with AzCopy
DESCRIPTION: Instructions and guidance on using AzCopy, a command-line utility for copying data to and from Azure Blob storage and Azure Files. It covers installation, basic usage, and advanced features for efficient data transfer.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/fsharp/using-fsharp-on-azure/blob-storage.md#_snippet_18

LANGUAGE: APIDOC
CODE:
```
AzCopy v10:
  URL: https://learn.microsoft.com/en-us/azure/storage/common/storage-use-azcopy-v10
  Description: AzCopy is a command-line utility designed for high-performance copying of data to and from Azure Blob storage and Azure Files. This documentation covers how to download, install, and use AzCopy for various scenarios, including uploading, downloading, copying between storage accounts, and synchronizing data. It details command syntax, authentication methods (SAS tokens, managed identities), and options for optimizing transfer speeds.
```

----------------------------------------

TITLE: WCF Tutorials Overview
DESCRIPTION: This section outlines the WCF tutorial series, covering service contract definition, implementation, hosting, and client creation. It highlights the use of Visual Studio and mentions alternative tools and hosting methods.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/framework/wcf/getting-started-tutorial.md#_snippet_0

LANGUAGE: APIDOC
CODE:
```
Tutorial: Define a service contract
  - Creates a WCF contract with a user-defined interface.
  - Defines the functionality exposed by the service.

Tutorial: Implement a service contract
  - Implements the defined contract with a service class.

Tutorial: Host and run a basic service
  - Configures an endpoint for the service.
  - Hosts the service in a console application.
  - Mentions hosting services under IIS and configuring services within a configuration file.

Tutorial: Create a client
  - Retrieves metadata for creating a WCF client proxy from a WCF service.
  - Uses Visual Studio to add a service reference or the ServiceModel Metadata Utility tool.
  - Specifies the endpoint the client uses to access the service.

Tutorial: Use a client
  - Uses the WCF client proxy to call service operations.
```

----------------------------------------

TITLE: Example: Installing .NET Runtime 5.0.15 (macOS Bash)
DESCRIPTION: This Bash command provides a concrete example of using `dotnet-install.sh` to install the .NET 5.0.15 runtime for x64 architecture into the default `/usr/local/share/dotnet/` directory on macOS. This helps resolve 'Required framework not found' errors.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/core/runtime-discovery/troubleshoot-app-launch.md#_snippet_12

LANGUAGE: bash
CODE:
```
./dotnet-install.sh --architecture x64 --install-dir /usr/local/share/dotnet/ --runtime dotnet --version 5.0.15
```

----------------------------------------

TITLE: Canceling .NET Framework 4.5 Setup
DESCRIPTION: This snippet illustrates how to cancel the .NET Framework 4.5 setup process programmatically. Cancellation is achieved by setting specific flags (`m_downloadAbort` and `m_installAbort`) within the MMIO section that the installer monitors.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/framework/deployment/how-to-get-progress-from-the-dotnet-installer.md#_snippet_2

LANGUAGE: cpp
CODE:
```
Abort method to set the m_downloadAbort and m_ installAbort flags
```

----------------------------------------

TITLE: Running the Hello World Routing Service Sample
DESCRIPTION: Instructions on how to build and run the Hello World Routing Service sample using Visual Studio. It details the steps to start the client, service, and routing applications, and the expected output.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/framework/wcf/samples/hello-world-with-the-routing-service.md#_snippet_0

LANGUAGE: console
CODE:
```
Add(100,15.99) = 115.99

Subtract(145,76.54) = 68.46

Multiply(9,81.25) = 731.25

Divide(22,7) = 3.14285714285714
```

----------------------------------------

TITLE: Pack and Publish .NET Project
DESCRIPTION: Commands to pack the .NET project into a NuGet package and then publish it to a NuGet source. Includes instructions for publishing to the official NuGet.org or a test environment.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/ai/quickstarts/build-mcp-server.md#_snippet_10

LANGUAGE: bash
CODE:
```
dotnet pack -c Release
```

LANGUAGE: bash
CODE:
```
dotnet nuget push bin/Release/*.nupkg --api-key <your-api-key> --source https://api.nuget.org/v3/index.json
```

LANGUAGE: bash
CODE:
```
dotnet nuget push bin/Release/*.nupkg --api-key <your-api-key> --source https://apiint.nugettest.org/v3/index.json
```

----------------------------------------

TITLE: Generic Host with Application Lifetime
DESCRIPTION: Demonstrates how to use the Generic Host and manage application lifetime with a hosted service. This example shows the basic setup for a background service.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/core/extensions/access-by-line.txt#_snippet_0

LANGUAGE: csharp
CODE:
```
namespace ConsoleApp
{
    using Microsoft.Extensions.Hosting;
    using System;
    using System.Threading;
    using System.Threading.Tasks;

    public class ExampleHostedService : IHostedService, IDisposable
    {
        public Task StartAsync(CancellationToken cancellationToken)
        {
            Console.WriteLine("Hosted Service is starting.");
            // Perform startup logic here
            return Task.CompletedTask;
        }

        public Task StopAsync(CancellationToken cancellationToken)
        {
            Console.WriteLine("Hosted Service is stopping.");
            // Perform cleanup logic here
            return Task.CompletedTask;
        }

        public void Dispose()
        {
            Console.WriteLine("Hosted Service is disposing.");
            // Dispose resources here
        }
    }

    class Program
    {
        static void Main(string[] args)
        {
            CreateHostBuilder(args).Build().Run();
        }

        public static IHostBuilder CreateHostBuilder(string[] args) =>
            Host.CreateDefaultBuilder(args)
                .ConfigureServices((hostContext, services)
                    => services.AddHostedService<ExampleHostedService>());
    }
}
```

----------------------------------------

TITLE: Installation Steps
DESCRIPTION: Outlines the step-by-step process for installing the .NET Framework, including running the installer or saving it for redistribution, and selecting system architecture.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/framework/install/guide-for-developers.md#_snippet_19

LANGUAGE: APIDOC
CODE:
```
APIDOC:
  description: Steps to install or download .NET Framework.
  steps:
    - action: Open the download page for the desired .NET Framework version.
      details: Refer to the provided download links.
    - action: Select the language for the download page.
      note: This only affects the download page display, not .NET Framework resources.
    - action: Choose 'Download'.
    - action: If prompted, select the download matching your system architecture and choose 'Next'.
    - action: When the download prompt appears, choose one:
      options:
        - 'Run': To install .NET Framework on the current computer.
        - 'Save': To download .NET Framework for redistribution.
    - action: If additional language resources are needed, follow instructions to install language packs.
```

----------------------------------------

TITLE: MMIO Server Implementation Example
DESCRIPTION: Illustrates how a server typically interacts with MMIO operations. It involves creating a file, launching a redistributable with a pipe name, and implementing the OnProgress, Send, and Finished methods to manage the process and UI.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/framework/deployment/how-to-get-progress-from-the-dotnet-installer.md#_snippet_13

LANGUAGE: cpp
CODE:
```
// Server creates a random MMIO file name, creates the file, and launches the redistributable.
// Example: server.CreateSection(...);
// Example: CreateProcess(..., "-pipe someFileSectionName");
// Server should implement OnProgress, Send, and Finished methods.
```

----------------------------------------

TITLE: .NET Tool List Output Example
DESCRIPTION: Example output from 'dotnet tool list', showing installed tools, their versions, commands, and the path to their manifest files.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/core/tools/global-tools.md#_snippet_11

LANGUAGE: console
CODE:
```
Package Id      Version      Commands       Manifest
-------------------------------------------------------------------------------------------
botsay          1.0.0        botsay         /home/name/repository/.config/dotnet-tools.json
dotnetsay       2.1.3        dotnetsay      /home/name/repository/.config/dotnet-tools.json
```

----------------------------------------

TITLE: Build a Multi-platform App with .NET MAUI
DESCRIPTION: Tutorial for building your first multi-platform application using .NET MAUI.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/standard/get-started.md#_snippet_6

LANGUAGE: csharp
CODE:
```
public partial class App : Application
{
    public App()
    {
        InitializeComponent();
        MainPage = new NavigationPage(new MainPage());
    }
}
```

----------------------------------------

TITLE: Install MCP C# SDK
DESCRIPTION: Adds the MCP C# SDK package to your .NET project. This is the first step to start building MCP clients and servers.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/ai/get-started-mcp.md#_snippet_2

LANGUAGE: dotnetcli
CODE:
```
dotnet add package ModelContextProtocol --prerelease
```

----------------------------------------

TITLE: Example User Query
DESCRIPTION: An example of a user question that can be asked to the chat application to test response behavior, particularly in relation to plan details.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/ai/get-started-app-chat-template.md#_snippet_10

LANGUAGE: text
CODE:
```
What is included in my Northwind Health Plus plan that is not in standard?
```

----------------------------------------

TITLE: Create a Windows Desktop App
DESCRIPTION: Tutorials for creating Windows desktop applications using WPF, Windows Forms, or Universal Windows Platform (UWP) with C#.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/standard/get-started.md#_snippet_7

LANGUAGE: csharp
CODE:
```
public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();
    }
}
```

----------------------------------------

TITLE: Create a Console App
DESCRIPTION: Tutorials for creating a .NET console application using Visual Studio Code or Visual Studio.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/standard/get-started.md#_snippet_0

LANGUAGE: dotnet
CODE:
```
using System;

Console.WriteLine("Hello, World!");
```

----------------------------------------

TITLE: Console Output Example
DESCRIPTION: Shows the expected output when the F# console application is executed.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/fsharp/get-started/get-started-visual-studio.md#_snippet_2

LANGUAGE: console
CODE:
```
12 squared is: 144!
```

----------------------------------------

TITLE: Create a Game using Unity
DESCRIPTION: Tutorial for creating a game using Unity with .NET.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/standard/get-started.md#_snippet_8

LANGUAGE: csharp
CODE:
```
using UnityEngine;

public class PlayerController : MonoBehaviour
{
    public float moveSpeed = 5f;

    void Update()
    {
        float horizontalInput = Input.GetAxis("Horizontal");
        transform.Translate(Vector3.right * horizontalInput * moveSpeed * Time.deltaTime);
    }
}
```

----------------------------------------

TITLE: Azure Storage Connection String Example
DESCRIPTION: Provides an example of how to define and assign your Azure Storage connection string within an F# script for authentication.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/fsharp/using-fsharp-on-azure/table-storage.md#_snippet_2

LANGUAGE: fsharp
CODE:
```
let connectionString = "<YOUR_CONNECTION_STRING>"
```

----------------------------------------

TITLE: .NET Compiler Platform SDK Installation
DESCRIPTION: To get started with code generation, analysis, and refactoring using the .NET Compiler Platform SDK, you need to install it. The following include directive points to the installation instructions.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/csharp/roslyn-sdk/index.md#_snippet_6

LANGUAGE: csharp
CODE:
```
[!INCLUDE[interactive-note](~/includes/roslyn-installation.md)]
```

----------------------------------------

TITLE: Install MSTest packages for test infrastructure projects
DESCRIPTION: This snippet shows how to directly install MSTest.TestFramework and MSTest.Analyzers into a test infrastructure project. This is recommended when creating helper projects used by multiple test projects.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/core/testing/unit-testing-mstest-getting-started.md#_snippet_2

LANGUAGE: xml
CODE:
```
<PackageReference Include="MSTest.TestFramework" Version="X.Y.Z" />
<PackageReference Include="MSTest.Analyzers" Version="X.Y.Z" />
```

----------------------------------------

TITLE: Navigate to Project Directory
DESCRIPTION: Changes the current directory to the newly created MCP server project.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/ai/quickstarts/build-mcp-server.md#_snippet_2

LANGUAGE: bash
CODE:
```
cd SampleMcpServer
```

----------------------------------------

TITLE: Database Setup and Execution
DESCRIPTION: Instructions for setting up the project's SQL Server databases and running the solution. This includes database creation via `Setup.cmd`, Visual Studio project configuration for multiple startup projects, building the solution, and running without debugging.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/framework/windows-workflow-foundation/samples/hiring-process.md#_snippet_6

LANGUAGE: bash
CODE:
```
Setup.cmd
```

LANGUAGE: csharp
CODE:
```
CareersWebSite
InternalClient
HiringRequestService
ResumeRequestService
```

----------------------------------------

TITLE: Create New MCP Server Project
DESCRIPTION: Creates a new MCP server application using the installed template. Replace 'SampleMcpServer' with your desired project name.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/ai/quickstarts/build-mcp-server.md#_snippet_1

LANGUAGE: bash
CODE:
```
dotnet new mcpserver -n SampleMcpServer
```

----------------------------------------

TITLE: Visual Basic Documentation Links
DESCRIPTION: Provides links to essential Visual Basic documentation, including what's new, additional resources for programmers, and sample code repositories.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/visual-basic/getting-started/index.md#_snippet_2

LANGUAGE: visualbasic
CODE:
```
- [What's new for Visual Basic](../whats-new/index.md)
- [Additional Resources for Visual Basic Programmers](additional-resources.md)
- [Samples](https://github.com/dotnet/docs/tree/main/samples/snippets/visualbasic)
```

----------------------------------------

TITLE: Example User Query for Deductible
DESCRIPTION: An example of a user question to test the chat application's ability to retrieve specific information like a deductible, demonstrating the impact of semantic ranking.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/ai/get-started-app-chat-template.md#_snippet_11

LANGUAGE: text
CODE:
```
What is my deductible?
```

----------------------------------------

TITLE: Basic EventSource Logging Example
DESCRIPTION: Demonstrates how to create a minimal EventSource class in C# to log a custom event with string and integer parameters. This example shows the basic structure for defining an event and writing it.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/core/diagnostics/eventsource-getting-started.md#_snippet_0

LANGUAGE: C#
CODE:
```
using System.Diagnostics.Tracing;

namespace EventSourceDemo
{
    public static class Program
    {
        public static void Main(string[] args)
        {
            DemoEventSource.Log.AppStarted("Hello World!", 12);
        }
    }

    [EventSource(Name = "Demo")]
    class DemoEventSource : EventSource
    {
        public static DemoEventSource Log { get; } = new DemoEventSource();

        [Event(1)]
        public void AppStarted(string message, int favoriteNumber) => WriteEvent(1, message, favoriteNumber);
    }
}
```

----------------------------------------

TITLE: Install OpenAI Packages
DESCRIPTION: Installs the necessary NuGet packages for integrating with OpenAI services in a .NET application. Includes OpenAI client, AI extensions, and configuration packages.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/ai/quickstarts/prompt-model.md#_snippet_2

LANGUAGE: bash
CODE:
```
dotnet add package OpenAI
dotnet add package Microsoft.Extensions.AI.OpenAI --prerelease
dotnet add package Microsoft.Extensions.Configuration
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
```

----------------------------------------

TITLE: Get Progress from the .NET Framework 4.5 Installer
DESCRIPTION: Describes how to silently initiate and monitor the .NET Framework setup process, allowing for the display of custom progress views. This is useful for integrating installer progress into other applications.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/framework/deployment/index.md#_snippet_17

LANGUAGE: dotnet
CODE:
```
## How to: Get Progress from the .NET Framework 4.5 Installer

Describes how to silently launch and track the .NET Framework setup process while showing your own view of the setup progress.
```

----------------------------------------

TITLE: Create a Class Library
DESCRIPTION: Tutorials for creating a .NET class library using Visual Studio Code or Visual Studio.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/standard/get-started.md#_snippet_10

LANGUAGE: csharp
CODE:
```
public class MyLibrary
{
    public string GetMessage() => "Hello from the library!";
}
```

----------------------------------------

TITLE: CompatibilitySuppressions.xml Example
DESCRIPTION: This XML snippet provides an example of a CompatibilitySuppressions.xml file. It contains a suppression entry for the CP0002 diagnostic ID, specifically targeting the removed Connect(System.String) method, allowing the intentional breaking change.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/fundamentals/apicompat/package-validation/baseline-version-validator.md#_snippet_7

LANGUAGE: xml
CODE:
```
<?xml version="1.0" encoding="utf-8"?>
<Suppressions xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <Suppression>
    <DiagnosticId>CP0002</DiagnosticId>
    <Target>M:A.B.Connect(System.String)</Target>
    <Left>lib/net6.0/AdventureWorks.Client.dll</Left>
    <Right>lib/net6.0/AdventureWorks.Client.dll</Right>
    <IsBaselineSuppression>true</IsBaselineSuppression>
  </Suppression>
</Suppressions>
```

----------------------------------------

TITLE: .NET Framework Related Sections
DESCRIPTION: Links to related sections for getting started, what's new, tools, and samples/tutorials for the .NET Framework.

SOURCE: https://github.com/dotnet/docs/blob/main/docs/framework/development-guide.md#_snippet_2

LANGUAGE: dotnet
CODE:
```
## Related sections

[Get started](./get-started/index.md)
Provides a comprehensive overview of the .NET Framework and links to additional resources.

[What's new](./whats-new/index.md)
Describes key new features and changes in the latest version of the .NET Framework. Includes lists of new and obsolete types and members, and provides a guide for migrating your apps from the previous version of the .NET Framework.

[Tools](./tools/index.md)
Describes the tools that help you develop, configure, and deploy apps by using .NET Framework technologies.

[.NET samples and tutorials](/samples/browse/?expanded=dotnet&products=dotnet)
Provides links to samples and tutorials that help you learn about .NET.
```