Skip to content

Remove unnecessary mentions of C++ #11377

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jun 2, 2025
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
462 changes: 229 additions & 233 deletions xml/System.AddIn.Hosting/AddInToken.xml

Large diffs are not rendered by default.

106 changes: 52 additions & 54 deletions xml/System.AddIn.Hosting/QualificationDataItem.xml
Original file line number Diff line number Diff line change
Expand Up @@ -23,23 +23,21 @@
<Docs>
<summary>Represents information supplied by the developer of a pipeline segment, for use by the host.</summary>
<remarks>
<format type="text/markdown"><![CDATA[

## Remarks
Each item of qualification data consists of a name/value pair that was applied to a pipeline segment by using the <xref:System.AddIn.Pipeline.QualificationDataAttribute> attribute, to provide information that qualifies the use of the segment (for example, the recommended isolation level for the segment). The <xref:System.AddIn.Hosting.QualificationDataItem> structure contains one name/value pair and the type of pipeline segment it was applied to.

Use the <xref:System.AddIn.Hosting.AddInToken.QualificationData%2A?displayProperty=nameWithType> property to get a nested set of dictionaries that contains <xref:System.AddIn.Hosting.QualificationDataItem> structures for the pipeline segments associated with an <xref:System.AddIn.Hosting.AddInToken>.

Alternatively, use the <xref:System.AddIn.Hosting.AddInToken.GetEnumerator%2A?displayProperty=nameWithType> method to get an enumerator for the <xref:System.AddIn.Hosting.QualificationDataItem> structures of the pipeline segments associated with a token, or simply use a `foreach` statement (`For Each` in Visual Basic, `for each` in Visual C++) to treat the token as if it were a collection of <xref:System.AddIn.Hosting.QualificationDataItem> structures.



## Examples
The following example lists the qualification data for the pipeline segments associated with each <xref:System.AddIn.Hosting.AddInToken> in a collection of tokens.

<format type="text/markdown"><![CDATA[

## Remarks
Each item of qualification data consists of a name/value pair that was applied to a pipeline segment by using the <xref:System.AddIn.Pipeline.QualificationDataAttribute> attribute, to provide information that qualifies the use of the segment (for example, the recommended isolation level for the segment). The <xref:System.AddIn.Hosting.QualificationDataItem> structure contains one name/value pair and the type of pipeline segment it was applied to.

Use the <xref:System.AddIn.Hosting.AddInToken.QualificationData%2A?displayProperty=nameWithType> property to get a nested set of dictionaries that contains <xref:System.AddIn.Hosting.QualificationDataItem> structures for the pipeline segments associated with an <xref:System.AddIn.Hosting.AddInToken>.

Alternatively, use the <xref:System.AddIn.Hosting.AddInToken.GetEnumerator%2A?displayProperty=nameWithType> method to get an enumerator for the <xref:System.AddIn.Hosting.QualificationDataItem> structures of the pipeline segments associated with a token, or simply use a `foreach` statement (`For Each` in Visual Basic) to treat the token as if it were a collection of <xref:System.AddIn.Hosting.QualificationDataItem> structures.

## Examples
The following example lists the qualification data for the pipeline segments associated with each <xref:System.AddIn.Hosting.AddInToken> in a collection of tokens.

:::code language="csharp" source="~/snippets/csharp/System.AddIn.Hosting/AddInController/Overview/P3Host.cs" id="Snippet12":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/addinP3Host/vb/p3host.vb" id="Snippet12":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/addinP3Host/vb/p3host.vb" id="Snippet12":::

]]></format>
</remarks>
</Docs>
Expand Down Expand Up @@ -120,19 +118,19 @@
<summary>Gets the name of the qualification data item.</summary>
<value>The name of the qualification data item.</value>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
Each item of qualification data consists of a name/value pair that was applied to a pipeline segment by using the <xref:System.AddIn.Pipeline.QualificationDataAttribute> attribute, to provide information to consumers of the add-in. The <xref:System.AddIn.Hosting.QualificationDataItem.Name%2A> property gets the name. Use the <xref:System.AddIn.Hosting.QualificationDataItem.Value%2A> property to get the value.
## Examples
The following example lists the qualification data for the pipeline segments associated with each <xref:System.AddIn.Hosting.AddInToken> in a collection of tokens. The <xref:System.AddIn.Hosting.QualificationDataItem.Name%2A> property is used to display the name of each item.
<format type="text/markdown"><![CDATA[

## Remarks
Each item of qualification data consists of a name/value pair that was applied to a pipeline segment by using the <xref:System.AddIn.Pipeline.QualificationDataAttribute> attribute, to provide information to consumers of the add-in. The <xref:System.AddIn.Hosting.QualificationDataItem.Name%2A> property gets the name. Use the <xref:System.AddIn.Hosting.QualificationDataItem.Value%2A> property to get the value.



## Examples
The following example lists the qualification data for the pipeline segments associated with each <xref:System.AddIn.Hosting.AddInToken> in a collection of tokens. The <xref:System.AddIn.Hosting.QualificationDataItem.Name%2A> property is used to display the name of each item.

:::code language="csharp" source="~/snippets/csharp/System.AddIn.Hosting/AddInController/Overview/P3Host.cs" id="Snippet12":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/addinP3Host/vb/p3host.vb" id="Snippet12":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/addinP3Host/vb/p3host.vb" id="Snippet12":::

]]></format>
</remarks>
</Docs>
Expand Down Expand Up @@ -221,22 +219,22 @@
<summary>Gets a value that identifies the pipeline segment the qualification data item was applied to.</summary>
<value>The kind of pipeline segment the data item was applied to.</value>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
When you enumerate qualification data, use this property to identify the qualification data that belongs to a particular segment of the pipeline.
<format type="text/markdown"><![CDATA[

## Remarks
When you enumerate qualification data, use this property to identify the qualification data that belongs to a particular segment of the pipeline.

> [!NOTE]
> The add-in model does not use qualification data that is applied to the host view of the add-in. As a result, when you enumerate qualification data you will not find any items whose <xref:System.AddIn.Hosting.QualificationDataItem.Segment%2A> property is <xref:System.AddIn.Hosting.AddInSegmentType.HostViewOfAddIn>.
## Examples
The following example lists the qualification data for the pipeline segments associated with each <xref:System.AddIn.Hosting.AddInToken> in a collection of tokens. The <xref:System.AddIn.Hosting.QualificationDataItem.Segment%2A> property is used to display the kind of segment.
> The add-in model does not use qualification data that is applied to the host view of the add-in. As a result, when you enumerate qualification data you will not find any items whose <xref:System.AddIn.Hosting.QualificationDataItem.Segment%2A> property is <xref:System.AddIn.Hosting.AddInSegmentType.HostViewOfAddIn>.



## Examples
The following example lists the qualification data for the pipeline segments associated with each <xref:System.AddIn.Hosting.AddInToken> in a collection of tokens. The <xref:System.AddIn.Hosting.QualificationDataItem.Segment%2A> property is used to display the kind of segment.

:::code language="csharp" source="~/snippets/csharp/System.AddIn.Hosting/AddInController/Overview/P3Host.cs" id="Snippet12":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/addinP3Host/vb/p3host.vb" id="Snippet12":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/addinP3Host/vb/p3host.vb" id="Snippet12":::

]]></format>
</remarks>
</Docs>
Expand Down Expand Up @@ -267,19 +265,19 @@
<summary>Gets the value of the qualification data item.</summary>
<value>The value of the item.</value>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
Each item of qualification data consists of a name/value pair that was applied to a pipeline segment by using the <xref:System.AddIn.Pipeline.QualificationDataAttribute> attribute, to provide information to consumers of the add-in. The <xref:System.AddIn.Hosting.QualificationDataItem.Value%2A> property gets the value. Use the <xref:System.AddIn.Hosting.QualificationDataItem.Name%2A> property to get the name.
## Examples
The following example lists the qualification data for the pipeline segments associated with each <xref:System.AddIn.Hosting.AddInToken> in a collection of tokens. The <xref:System.AddIn.Hosting.QualificationDataItem.Value%2A> property is used to display the value of the item.
<format type="text/markdown"><![CDATA[

## Remarks
Each item of qualification data consists of a name/value pair that was applied to a pipeline segment by using the <xref:System.AddIn.Pipeline.QualificationDataAttribute> attribute, to provide information to consumers of the add-in. The <xref:System.AddIn.Hosting.QualificationDataItem.Value%2A> property gets the value. Use the <xref:System.AddIn.Hosting.QualificationDataItem.Name%2A> property to get the name.



## Examples
The following example lists the qualification data for the pipeline segments associated with each <xref:System.AddIn.Hosting.AddInToken> in a collection of tokens. The <xref:System.AddIn.Hosting.QualificationDataItem.Value%2A> property is used to display the value of the item.

:::code language="csharp" source="~/snippets/csharp/System.AddIn.Hosting/AddInController/Overview/P3Host.cs" id="Snippet12":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/addinP3Host/vb/p3host.vb" id="Snippet12":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/addinP3Host/vb/p3host.vb" id="Snippet12":::

]]></format>
</remarks>
</Docs>
Expand Down
Loading