Skip to content

Commit f10d3e4

Browse files
committed
Merge branch 'main' of github.com:dotnet/docs into ca2265
2 parents d393603 + 8fa23a9 commit f10d3e4

File tree

88 files changed

+327
-474
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

88 files changed

+327
-474
lines changed

.openpublishing.redirection.csharp.json

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4052,6 +4052,10 @@
40524052
"source_path_from_root": "/docs/csharp/roslyn/index.md",
40534053
"redirect_url": "/dotnet/csharp/roslyn-sdk/"
40544054
},
4055+
{
4056+
"source_path_from_root": "/docs/csharp/roslyn-sdk/source-generators-overview.md",
4057+
"redirect_url": "/dotnet/csharp/roslyn-sdk/#source-generators"
4058+
},
40554059
{
40564060
"source_path_from_root": "/docs/csharp/whats-new/tutorials/static-abstract-interface-methods.md",
40574061
"redirect_url": "/dotnet/csharp/whats-new/tutorials/static-virtual-interface-members"

docs/architecture/maui/mvvm-community-toolkit-features.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -115,7 +115,7 @@ For more detailed information on implementing commands, see the section [Impleme
115115

116116
## Source Generators
117117

118-
Using the MVVM Toolkit components out-of-the-box allows you to greatly simplify our ViewModel. The MVVM Toolkit allows you to simplify common code use cases even further by using [Source Generators](../../csharp/roslyn-sdk/source-generators-overview.md). The MVVM Toolkit source generators look for specific attributes in our code and can generate wrappers for properties and commands.
118+
Using the MVVM Toolkit components out-of-the-box allows you to greatly simplify our ViewModel. The MVVM Toolkit allows you to simplify common code use cases even further by using [Source Generators](../../csharp/roslyn-sdk/index.md#source-generators). The MVVM Toolkit source generators look for specific attributes in our code and can generate wrappers for properties and commands.
119119

120120
> [!IMPORTANT]
121121
> The MVVM Toolkit Source Generators generate code that is additive to our existing objects. Because of this, any object that is leveraging a source generator will need to be marked as `partial`.

docs/azure/includes/dotnet-all.md

Lines changed: 31 additions & 32 deletions
Large diffs are not rendered by default.

docs/azure/includes/dotnet-new.md

Lines changed: 29 additions & 29 deletions
Large diffs are not rendered by default.

docs/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -123,3 +123,7 @@ In general, code should:
123123
- <xref:System.Security.Cryptography.CryptoStream.Read%2A?displayProperty=fullName>
124124
- <xref:System.Security.Cryptography.CryptoStream.ReadAsync%2A?displayProperty=fullName>
125125
- <xref:System.Security.Cryptography.CryptoStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)?displayProperty=fullName>
126+
127+
## See also
128+
129+
- [CA2022: Avoid inexact read with Stream.Read](../../../../fundamentals/code-analysis/quality-rules/ca2022.md)

docs/core/docker/build-container.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -126,7 +126,7 @@ If you pass a number on the command line to the app, it will only count up to th
126126
127127
## Publish .NET app
128128

129-
In order for the app to be suitable for an image creation it has to be built. The `dotnet publish` command is most apt for this, as it builds and publishes the app. For an in-depth reference, see [dotnet build](/dotnet/core/tools/dotnet-build) and [dotnet publish](/dotnet/core/tools/dotnet-publish) commands documentation.
129+
In order for the app to be suitable for an image creation it has to be built. The `dotnet publish` command is most apt for this, as it builds and publishes the app. For an in-depth reference, see [dotnet build](../tools/dotnet-build.md) and [dotnet publish](../tools/dotnet-publish.md) commands documentation.
130130

131131
```dotnetcli
132132
dotnet publish -c Release

docs/core/extensions/configuration-generator.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ ms.date: 10/09/2024
1010

1111
Starting with .NET 8, a configuration binding source generator was introduced that intercepts specific call sites and generates their functionality. This feature provides a [Native ahead-of-time (AOT)](../deploying/native-aot/index.md) and [trim-friendly](../deploying/trimming/trim-self-contained.md) way to use the [configuration binder](configuration.md#binding), without the use of the reflection-based implementation. Reflection requires dynamic code generation, which isn't supported in AOT scenarios.
1212

13-
This feature is possible with the advent of [C# interceptors](/dotnet/csharp/whats-new/csharp-12#interceptors) that were introduced in C# 12. Interceptors allow the compiler to generate source code that intercepts specific calls and substitutes them with generated code.
13+
This feature is possible with the advent of [C# interceptors](../../csharp/whats-new/csharp-12.md#interceptors) that were introduced in C# 12. Interceptors allow the compiler to generate source code that intercepts specific calls and substitutes them with generated code.
1414

1515
## Enable the configuration source generator
1616

@@ -52,7 +52,7 @@ The preceding code:
5252
When the application is built, the configuration source generator intercepts the call to `GetValue<T>` and generates the binding code.
5353

5454
> [!IMPORTANT]
55-
> When the `PublishAot` property is set to `true` (or any other AOT warnings are enabled) and the `EnabledConfigurationBindingGenerator` property is set to `false`, warning `IL2026` is raised. This warning indicates that members are attributed with [RequiresUnreferencedCode](xref:System.Diagnostics.CodeAnalysis.RequiresUnreferencedCodeAttribute) may break when trimming. For more information, see [IL2026](/dotnet/core/deploying/trimming/trim-warnings/il2026).
55+
> When the `PublishAot` property is set to `true` (or any other AOT warnings are enabled) and the `EnabledConfigurationBindingGenerator` property is set to `false`, warning `IL2026` is raised. This warning indicates that members are attributed with [RequiresUnreferencedCode](xref:System.Diagnostics.CodeAnalysis.RequiresUnreferencedCodeAttribute) may break when trimming. For more information, see [IL2026](../deploying/trimming/trim-warnings/il2026.md).
5656
5757
### Explore the source generated code
5858

docs/core/project-sdk/msbuild-props.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -407,14 +407,16 @@ For example, for a .NET 5 app and an RID of `win-x64`, the following setting cha
407407

408408
### CopyLocalLockFileAssemblies
409409

410-
The `CopyLocalLockFileAssemblies` property is useful for plugin projects that have dependencies on other libraries. If you set this property to `true`, any NuGet package dependencies are copied to the output directory. That means you can use the output of `dotnet build` to run your plugin on any machine.
410+
The `CopyLocalLockFileAssemblies` property is useful for plugin projects that have dependencies on other libraries. If you set this property to `true`, any transitive NuGet package dependencies are copied to the output directory. That means you can use the output of `dotnet build` to run your plugin on any machine.
411411

412412
```xml
413413
<PropertyGroup>
414414
<CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
415415
</PropertyGroup>
416416
```
417417

418+
The default value of `CopyLocalLockFileAssemblies` can vary based on the output type. For example, for class libraries the default value is `false`, while for console applications the default is `true`. You can specify this property explicitly to override the default if needed.
419+
418420
> [!TIP]
419421
> Alternatively, you can use `dotnet publish` to publish the class library. For more information, see [dotnet publish](../tools/dotnet-publish.md).
420422

docs/core/testing/unit-testing-platform-architecture-extensions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -854,7 +854,7 @@ Let's examine the apis and their mean:
854854
* `OneOrMore`: Represents an argument arity of one or more.
855855
* `ExactlyOne`: Represents an argument arity of exactly one.
856856

857-
For examples, refer to the [System.CommandLine arity table](/dotnet/standard/commandline/syntax#argument-arity).
857+
For examples, refer to the [System.CommandLine arity table](../../standard/commandline/syntax.md#argument-arity).
858858

859859
`bool isHidden`: This property signifies that the option is available for use but will not be displayed in the description when `--help` is invoked.
860860

docs/core/whats-new/dotnet-6.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -94,7 +94,7 @@ Many improvements have been made in <xref:System.Text.Json?displayProperty=fullN
9494

9595
### Source generator
9696

97-
.NET 6 adds a new [source generator](../../csharp/roslyn-sdk/source-generators-overview.md) for <xref:System.Text.Json?displayProperty=fullName>. Source generation works with <xref:System.Text.Json.JsonSerializer> and can be configured in multiple ways. It can improve performance, reduce memory usage, and facilitate assembly trimming. For more information, see [How to choose reflection or source generation in System.Text.Json](../../standard/serialization/system-text-json/source-generation-modes.md) and [How to use source generation in System.Text.Json](../../standard/serialization/system-text-json/source-generation.md).
97+
.NET 6 adds a new [source generator](../../csharp/roslyn-sdk/index.md#source-generators) for <xref:System.Text.Json?displayProperty=fullName>. Source generation works with <xref:System.Text.Json.JsonSerializer> and can be configured in multiple ways. It can improve performance, reduce memory usage, and facilitate assembly trimming. For more information, see [How to choose reflection or source generation in System.Text.Json](../../standard/serialization/system-text-json/source-generation-modes.md) and [How to use source generation in System.Text.Json](../../standard/serialization/system-text-json/source-generation.md).
9898

9999
### Writeable DOM
100100

0 commit comments

Comments
 (0)