Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ The following example uses the `join … in … on … equals … into …` clau
:::code language="csharp" source="./snippets/standard-query-operators/JoinOverviewExamples.cs" id="GroupJoinQuerySyntax":::

You can express the preceding query by using method syntax, as shown in the following example:

:::code language="csharp" source="./snippets/standard-query-operators/JoinOverviewExamples.cs" id="GroupJoinMethodSyntax":::

## Perform inner joins
Expand Down Expand Up @@ -148,7 +148,7 @@ The equivalent query using method syntax is shown in the following code:

## Perform outer joins

.NET 10 includes [`LeftJoin`](https://learn.microsoft.com/dotnet/api/?view=net-10.0&term=LeftJoin) and [`RightJoin`](https://learn.microsoft.com/dotnet/api/?view=net-10.0&term=RightJoin) methods in the <xref:System.Linq.Enumerable?displayProperty=nameWithType> and <xref:System.Linq.Queryable?displayProperty=nameWithType> classes. These methods perform an *outer left equijoin*, and an *outer right equijoin*, respectively. An outer left equijoin is a join where every member of the first sequence is included in the output sequence, even if the second sequence doesn't include a match. An outer right equijoin is a join where every member of the second sequence is included in the output sequence, even if the first sequence doesn't include a match.
.NET 10 includes [`LeftJoin`](/dotnet/api/?term=LeftJoin) and [`RightJoin`](/dotnet/api/?term=RightJoin) methods in the <xref:System.Linq.Enumerable?displayProperty=nameWithType> and <xref:System.Linq.Queryable?displayProperty=nameWithType> classes. These methods perform an *outer left equijoin*, and an *outer right equijoin*, respectively. An outer left equijoin is a join where every member of the first sequence is included in the output sequence, even if the second sequence doesn't include a match. An outer right equijoin is a join where every member of the second sequence is included in the output sequence, even if the first sequence doesn't include a match.

## Emulate a left outer join

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,6 @@ f1_keywords:
helpviewer_keywords:
- "add Element"
- "<add> Element"
ms.assetid: 8734efdc-00f6-4a65-bba6-084c5bc65246
---
# `<add>` element for \<appSettings>

Expand All @@ -27,16 +26,16 @@ Adds a custom application setting.

## Attributes

| | Description |
| --------- | ----------- |
| `key` | Required attribute.<br><br>Specifies the name of the key to add. |
| `value` | Required attribute.<br><br>Specifies the value of the key to add. |
| Attribute | Description |
|-----------|-------------------------------------------------------------------|
| `key` | Required attribute.<br><br>Specifies the name of the key to add. |
| `value` | Required attribute.<br><br>Specifies the value of the key to add. |

## Parent element

| | Description |
| --- | ----------- |
| [**\<appSettings>**](appsettings-element-for-configuration.md) | Contains custom application settings, such as file paths, XML Web service URLs, or any other custom configuration information for an application. |
| Parent element | Description |
|-------------------------------------------------------------|-------------|
| [`<appSettings>`](appsettings-element-for-configuration.md) | Contains custom application settings, such as file paths, XML Web service URLs, or any other custom configuration information for an application. |

## Child elements

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,6 @@ f1_keywords:
helpviewer_keywords:
- "appSettings Element"
- "<appSettings> Element"
ms.assetid: 39694cc4-6b84-45a6-9329-385a0d8b48fe
---
# `<appSettings>` element for \<configuration>

Expand All @@ -26,20 +25,20 @@ Contains custom application settings. This is a predefined configuration section

## Attribute

| | Description |
| Attribute | Description |
| --------- | ----------- |
| `file` | Optional attribute.<br><br>Specifies a relative path to an external file containing custom application configuration settings. The specified file contains the same kind of settings that are specified in the `<add>`, `<remove>`, and `<clear>` elements and uses the same key/value pair format as those elements.<br><br>The path specified is relative to the main configuration file. For a Windows Forms application, this is the binary folder (such as */bin/debug*), not the location of the application configuration file. For Web Forms applications, the path is relative to the application root, where the *web.config* file is located.<br><br>The runtime ignores the attribute if the specified file can't be found. |
| `file` | Optional attribute.<br><br>Specifies a relative path to an external file containing custom application configuration settings. The specified file contains the same kind of settings that are specified in the `<add>`, `<remove>`, and `<clear>` elements and uses the same key/value pair format as those elements.<br><br>The path specified is relative to the main configuration file. For a Windows Forms application, this is the binary folder (such as */bin/debug*), not the location of the application configuration file. For Web Forms applications, the path is relative to the application root, where the *web.config* file is located.<br><br>The runtime ignores the attribute if the specified file can't be found. |

## Parent element

| | Description |
| --- | ----------- |
| [`<configuration>` Element](../configuration-element.md) | The root element in every configuration file used by the common language runtime and .NET Framework applications. |
| Parent element | Description |
|--------------------------------------------------|-------------|
| [`<configuration>`](../configuration-element.md) | The root element in every configuration file used by the common language runtime and .NET Framework applications. |

## Child elements

| | Description |
| --- | ----------- |
| Child element | Description |
|----------------------------------------------|------------------------------------|
| [**\<add>**](add-element-for-appsettings.md) | Adds a custom application setting. |
| [**\<clear>**](clear-element-for-appsettings.md) | Clears all previously defined application settings. |
| [**\<remove>**](remove-element-for-appsettings.md) | Removes a previously defined application setting. |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,6 @@ f1_keywords:
helpviewer_keywords:
- "remove Element"
- "<remove> Element"
ms.assetid: 218c4464-e007-4539-803f-7c8b0a909fd8
---
# `<remove>` element for `<appSettings>`

Expand All @@ -27,15 +26,15 @@ Removes custom application settings.

### Attribute

| | Description |
| ------- | ----------- |
| `key` | Required attribute.<br><br>Specifies the name of the key to remove. |
| Attribute | Description |
|-----------|---------------------------------------------------------------------|
| `key` | Required attribute.<br><br>Specifies the name of the key to remove. |

### Parent element

| | Description |
| --- | ----------- |
| [**\<appSettings>**](appsettings-element-for-configuration.md) | Contains custom application settings, such as file paths, XML Web service URLs, or any other custom configuration information for an application. |
| Parent element | Description |
|-------------------------------------------------------------|-------------|
| [`<appSettings>`](appsettings-element-for-configuration.md) | Contains custom application settings, such as file paths, XML Web service URLs, or any other custom configuration information for an application. |

## Child elements

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,6 @@ f1_keywords:
helpviewer_keywords:
- "assemblyBinding Element"
- "<assemblyBinding> Element"
ms.assetid: 6cc55983-b894-449b-8e26-b258e53939cd
---

# `<assemblyBinding>` element for \<configuration>
Expand All @@ -27,21 +26,21 @@ Specifies assembly binding policy at the configuration level.

## Attribute

| | Description |
| --------- | ----------- |
| `xmlns` | Required attribute.<br><br>Specifies the XML namespace required for assembly binding. Use the string "urn:schemas-microsoft-com:asm.v1" as the value. |
| Attribute | Description |
|-----------|-------------|
| `xmlns` | Required attribute.<br><br>Specifies the XML namespace required for assembly binding. Use the string "urn:schemas-microsoft-com:asm.v1" as the value. |

## Parent element

| | Description |
| --- | ----------- |
| [**\<configuration>**](configuration-element.md) | The root element in every configuration file used by the common language runtime and .NET Framework applications. |
| Parent element | Description |
|-----------------------------------------------|-------------|
| [`<configuration>`](configuration-element.md) | The root element in every configuration file used by the common language runtime and .NET Framework applications. |

## Child element

| | Description |
| --- | ----------- |
| [**\<linkedConfiguration>**](linkedconfiguration-element.md) | Specifies a configuration file to include. |
| Child element | Description |
|-----------------------------------------------------------|--------------------------------------------|
| [`<linkedConfiguration>`](linkedconfiguration-element.md) | Specifies a configuration file to include. |

## Remarks

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,9 +29,9 @@ None

## Parent element

| | Description |
| --- | ------------|
| [`<sectionName>` Element](custom-element-2.md) | Defines settings for custom configuration sections that use the <xref:System.Configuration.NameValueSectionHandler> and <xref:System.Configuration.DictionarySectionHandler> classes. |
| Parent element | Description |
|----------------------------------------|-------------|
| [`<sectionName>`](custom-element-2.md) | Defines settings for custom configuration sections that use the <xref:System.Configuration.NameValueSectionHandler> and <xref:System.Configuration.DictionarySectionHandler> classes. |

## Child elements

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,6 @@ helpviewer_keywords:
- "custom elements"
- "configuration schema [.NET Framework], custom settings in configuration files"
- "elements [.NET Framework], custom settings in configuration files"
ms.assetid: 6e4cc793-c526-4007-b4e9-37d56295f2cb
---
# Configuration sections schema

Expand All @@ -20,17 +19,15 @@ The configuration sections schema contains elements that define custom settings
[**\<section>**](section-element.md)
[**\<sectionGroup>**](sectiongroup-element-for-configsections.md)

| | Description |
| Element | Description |
| --- | ----------- |
| [**\<configSections>**](configsections-element-for-configuration.md) | Contains configuration section and namespace declarations. |
| [`<configSections>`](configsections-element-for-configuration.md) | Contains configuration section and namespace declarations. |
| [`<section>` for `<configSections>` and `<sectionGroup>`](section-element.md) | Contains a configuration section declaration. |
| [`<sectionGroup>` for `<configSections>`](sectiongroup-element-for-configsections.md) | Defines a namespace for configuration sections. |

<a name="dep"></a>

## Unimplemented elements

The following elements have no impact and should not be used:

* **\<clear>**
* **\<remove>**
* `<clear>`
* `<remove>`
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,6 @@ f1_keywords:
helpviewer_keywords:
- "remove Element"
- "<remove> Element"
ms.assetid: 8d8af7f5-26c9-4db9-bbe4-b2a4e6949568
---
# `<remove>` element for NameValueSectionHandler and DictionarySectionHandler

Expand All @@ -25,15 +24,15 @@ Removes a previously defined setting.

## Attribute

| | Description |
| --------- | ----------- |
| `key` | Required attribute.<br><br>Specifies the name of the setting to remove. |
| Attribute | Description |
|-----------|-------------------------------------------------------------------------|
| `key` | Required attribute.<br><br>Specifies the name of the setting to remove. |

## Parent element

| Element | Description |
| ------- | ------------|
| [`<sectionName>` Element](custom-element-2.md) | Defines settings for custom configuration sections that use the <xref:System.Configuration.NameValueSectionHandler> and <xref:System.Configuration.DictionarySectionHandler> classes. |
| Element | Description |
|----------------------------------------|-------------|
| [`<sectionName>`](custom-element-2.md) | Defines settings for custom configuration sections that use the <xref:System.Configuration.NameValueSectionHandler> and <xref:System.Configuration.DictionarySectionHandler> classes. |

## Child elements

Expand Down
20 changes: 10 additions & 10 deletions docs/framework/configure-apps/file-schema/section-element.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,26 +34,26 @@ Contains a configuration section declaration.

## Required attributes

| | Description |
| --------- | ----------- |
| `name` | Specifies the name of the configuration section. |
| `type` | Specifies the name of the configuration section handler class that reads the section from the configuration file. The type value has the syntax "fully-qualified-section-handler-class-name, simple-assembly-name". The simple assembly name is the root filename without the *.dll* file extension. |
| Attribute | Description |
|-----------|--------------------------------------------------|
| `name` | Specifies the name of the configuration section. |
| `type` | Specifies the name of the configuration section handler class that reads the section from the configuration file. The type value has the syntax "fully-qualified-section-handler-class-name, simple-assembly-name". The simple assembly name is the root filename without the *.dll* file extension. |

## Optional attributes

The following attributes are applicable only for ASP.NET applications. The configuration system ignores these attributes for other application types.

| | Description |
| ------------------- | ----------- |
| Attribute | Description |
| ----------------- | ----------- |
| `allowDefinition` | Specifies which configuration file the section can be used in. Use one of the following values:<br><br>**Everywhere**<br>Allows the section to be used in any configuration file. This is the default.<br>**MachineOnly**<br>Allows the section to be used only in the machine configuration file (*Machine.config*).<br>**MachineToApplication**<br>Allows the section to be used in the machine configuration file or the application configuration file. |
| `allowLocation` | Determines whether the section can be used within the `<location>` element. Use one of the following values:<br><br>**true**<br>Allows the section to be used within the `<location>` element. This is the default.<br>**false**<br>Does not allow the section to be used within the `<location>` element. |

## Parent elements

| | Description |
| --- | ----------- |
| [`<configSections>` Element](configsections-element-for-configuration.md) | Contains configuration section and namespace declarations. |
| [`<sectionGroup>` Element](sectiongroup-element-for-configsections.md) | Defines a namespace for configuration sections. |
| Parent element | Description |
| ----------------------------------------------------------------- | ----------- |
| [`<configSections>`](configsections-element-for-configuration.md) | Contains configuration section and namespace declarations. |
| [`<sectionGroup>`](sectiongroup-element-for-configsections.md) | Defines a namespace for configuration sections. |

> [!NOTE]
> A `<section>` element is a child element of either `<configSections>` or `<sectionGroup>` but not both.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,21 +27,21 @@ Defines a namespace for configuration sections.

## Attribute

| | Description |
| --------- | ----------- |
| `name` | Required attribute.<br><br>Specifies the name of the section group you are defining. |
| Attribute | Description |
|-----------|-------------------------------------------------------------------------------------|
| `name` | Required attribute.<br><br>Specifies the name of the section group you're defining. |

## Parent element

| | Description |
| --- | ----------- |
| [`<configSections>` Element](configsections-element-for-configuration.md) | Contains configuration section and namespace declarations. |
| Parent element | Description |
|-------------------------------------------------------------------|-------------|
| [`<configSections>`](configsections-element-for-configuration.md) | Contains configuration section and namespace declarations. |

## Child elements

| | Description |
| --- | ----------- |
| [**\<section>**](section-element.md) | Contains a configuration section declaration. |
| Child element | Description |
|-----------------------------------|-----------------------------------------------|
| [`<section>`](section-element.md) | Contains a configuration section declaration. |

## Remarks

Expand Down
2 changes: 1 addition & 1 deletion docs/orleans/deployment/handling-failures.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Failure handling
description: Learn how to handle failures in Orleans apps.
ms.date: 05/23/2025
ms.topic: conceptual
ms.topic: article
---

# Failure handling
Expand Down
2 changes: 1 addition & 1 deletion docs/orleans/grains/code-generation.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Code generation
description: Learn how to use code generation in .NET Orleans.
ms.date: 05/23/2025
ms.topic: conceptual
ms.topic: article
zone_pivot_groups: orleans-version
---

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Event sourcing configuration
description: Learn about event sourcing configuration in .NET Orleans.
ms.date: 05/23/2025
ms.topic: conceptual
ms.topic: article
---

# Event sourcing configuration
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Immediate and delayed confirmation
description: Learn the differences between immediate and delayed confirmation in .NET Orleans.
ms.date: 05/23/2025
ms.topic: conceptual
ms.topic: article
---

# Immediate and delayed confirmations
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: The JournaledGrain API
description: Learn the concepts of the JournaledGrain API in .NET Orleans.
ms.date: 05/23/2025
ms.topic: conceptual
ms.topic: article
---

# JournaledGrain basics
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: JournaledGrain diagnostics
description: Learn how to use JournaledGrain diagnostics in .NET Orleans.
ms.date: 05/23/2025
ms.topic: conceptual
ms.topic: article
---

# JournaledGrain diagnostics
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Log-consistency providers
description: Learn about log-consistency providers in .NET Orleans.
ms.date: 03/29/2025
ms.topic: conceptual
ms.topic: article
---

# Log-consistency providers
Expand Down
2 changes: 1 addition & 1 deletion docs/orleans/grains/event-sourcing/notifications.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Notifications
description: Learn the concepts of notifications in .NET Orleans.
ms.date: 05/23/2025
ms.topic: conceptual
ms.topic: article
---

# Notifications
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Replicated grains
description: Learn the concepts of replicated grains in .NET Orleans.
ms.date: 05/23/2025
ms.topic: conceptual
ms.topic: article
---

# Replicated grains
Expand Down
2 changes: 1 addition & 1 deletion docs/orleans/grains/external-tasks-and-grains.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: External tasks and grains
description: Learn about external tasks and grains in .NET Orleans.
ms.date: 03/31/2025
ms.topic: conceptual
ms.topic: article
---

# External tasks and grains
Expand Down
2 changes: 1 addition & 1 deletion docs/orleans/grains/grain-extensions.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Grain extensions
description: Learn how to extend an Orleans Grain.
ms.date: 03/31/2025
ms.topic: conceptual
ms.topic: article
---

# Grain extensions
Expand Down
Loading
Loading