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
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 0 additions & 2 deletions xml/Microsoft.Win32/FileDialog.xml
Original file line number Diff line number Diff line change
Expand Up @@ -948,8 +948,6 @@ Open and save file dialog boxes have a **Favorite Links** panel on the left side

If more than one file name is selected (length of <xref:Microsoft.Win32.FileDialog.SafeFileNames*> is greater than one) then this property contains only the first selected file name.

See [Safe File Upload from an XBAP Sample](/previous-versions/dotnet/netframework-3.5/aa358504(v=vs.90)).

]]></format>
</remarks>
</Docs>
Expand Down
2 changes: 1 addition & 1 deletion xml/System.Activities.Statements/CompensableActivity.xml
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@
<format type="text/markdown"><![CDATA[

## Remarks
<xref:System.Activities.Statements.CompensableActivity> allows a developer to specify a <xref:System.Activities.Statements.CompensableActivity.Body*> activity that defines a long-running task that performs their core business logic. It also allows the developer to optionally specify a compensation and confirmation activity to schedule appropriate business logic in the event of errors or successful completion of the <xref:System.Activities.Statements.CompensableActivity.Body*>. Compensation and confirmation of a <xref:System.Activities.Statements.CompensableActivity> is invoked by using the <xref:System.Activities.Statements.CompensationToken> returned by the <xref:System.Activities.Statements.CompensableActivity>. <xref:System.Activities.Statements.CompensationToken> is an opaque, typed object returned after successful completion of a <xref:System.Activities.Statements.CompensableActivity> activity's <xref:System.Activities.Statements.CompensableActivity.Body*>. This <xref:System.Activities.Statements.CompensationToken> is used by the <xref:System.Activities.Statements.Confirm> and <xref:System.Activities.Statements.Compensate> activities to explicitly invoke confirmation and compensation of a <xref:System.Activities.Statements.CompensableActivity>. <xref:System.Activities.Statements.CompensableActivity> can be composed in a nested hierarchical fashion in the workflow. For more information, see [Compensation Programming Model](/previous-versions/dd489415(v=vs.100)).
<xref:System.Activities.Statements.CompensableActivity> allows a developer to specify a <xref:System.Activities.Statements.CompensableActivity.Body*> activity that defines a long-running task that performs their core business logic. It also allows the developer to optionally specify a compensation and confirmation activity to schedule appropriate business logic in the event of errors or successful completion of the <xref:System.Activities.Statements.CompensableActivity.Body*>. Compensation and confirmation of a <xref:System.Activities.Statements.CompensableActivity> is invoked by using the <xref:System.Activities.Statements.CompensationToken> returned by the <xref:System.Activities.Statements.CompensableActivity>. <xref:System.Activities.Statements.CompensationToken> is an opaque, typed object returned after successful completion of a <xref:System.Activities.Statements.CompensableActivity> activity's <xref:System.Activities.Statements.CompensableActivity.Body*>. This <xref:System.Activities.Statements.CompensationToken> is used by the <xref:System.Activities.Statements.Confirm> and <xref:System.Activities.Statements.Compensate> activities to explicitly invoke confirmation and compensation of a <xref:System.Activities.Statements.CompensableActivity>. <xref:System.Activities.Statements.CompensableActivity> can be composed in a nested hierarchical fashion in the workflow.

]]></format>
</remarks>
Expand Down
9 changes: 1 addition & 8 deletions xml/System.Activities.Statements/CompensationToken.xml
Original file line number Diff line number Diff line change
Expand Up @@ -21,14 +21,7 @@
</Attributes>
<Docs>
<summary>Provides a means to explicitly confirm or compensate a <see cref="T:System.Activities.Statements.CompensableActivity" /> once the <see cref="P:System.Activities.Statements.CompensableActivity.Body" /> of the <see cref="T:System.Activities.Statements.CompensableActivity" /> has successfully completed.</summary>
<remarks>
<format type="text/markdown"><![CDATA[

## Remarks
For more information, see [Compensation Programming Model](/previous-versions/dd489415(v=vs.100)).

]]></format>
</remarks>
<remarks>To be added.</remarks>
</Docs>
<Members />
</Type>
2 changes: 1 addition & 1 deletion xml/System.AddIn.Contract/IListContract`1.xml
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@
<format type="text/markdown"><![CDATA[

## Remarks
The <xref:System.AddIn.Pipeline.CollectionAdapters> class uses an <xref:System.AddIn.Contract.IListContract`1> interface to pass collections, in both directions, between the host and the add-in. It is recommended that you use the <xref:System.AddIn.Pipeline.CollectionAdapters> class instead of using this class directly in your code. For an example, see [Walkthrough: Passing Collections Between Hosts and Add-Ins](/previous-versions/dotnet/netframework-4.0/bb384207(v=vs.100)).
The <xref:System.AddIn.Pipeline.CollectionAdapters> class uses an <xref:System.AddIn.Contract.IListContract`1> interface to pass collections, in both directions, between the host and the add-in. It is recommended that you use the <xref:System.AddIn.Pipeline.CollectionAdapters> class instead of using this class directly in your code.

This class can be used to pass objects by reference between application domains because the objects are not serialized.

Expand Down
1 change: 0 additions & 1 deletion xml/System.AddIn.Hosting/AddInEnvironment.xml
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,6 @@

]]></format>
</remarks>
<related type="Article" href="/previous-versions/dotnet/netframework-4.0/bb384200(v=vs.100)">Add-Ins and Extensibility</related>
</Docs>
<Members>
<Member MemberName=".ctor">
Expand Down
1 change: 0 additions & 1 deletion xml/System.AddIn.Hosting/AddInProcess.xml
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,6 @@

]]></format>
</remarks>
<related type="Article" href="/previous-versions/dotnet/netframework-4.0/bb384200(v=vs.100)">Add-Ins and Extensibility</related>
</Docs>
<Members>
<MemberGroup MemberName=".ctor">
Expand Down
39 changes: 19 additions & 20 deletions xml/System.AddIn.Hosting/AddInSecurityLevel.xml
Original file line number Diff line number Diff line change
Expand Up @@ -22,24 +22,23 @@
<Docs>
<summary>Specifies the trust level that is granted to the application domain that an add-in is loaded into.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
The add-in system activates the add-in with the permission set that corresponds to the trust level specified for the add-in's application domain. That permission set is defined by the common language runtime's code access security (CAS) configuration.
The values of this enumeration cannot be combined by using the bitwise OR operation.
## Examples
The following example activates an add-in with a specified trust level.
<format type="text/markdown"><![CDATA[

## Remarks
The add-in system activates the add-in with the permission set that corresponds to the trust level specified for the add-in's application domain. That permission set is defined by the common language runtime's code access security (CAS) configuration.

The values of this enumeration cannot be combined by using the bitwise OR operation.



## Examples
The following example activates an add-in with a specified trust level.

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

]]></format>
</remarks>
<related type="Article" href="/previous-versions/dotnet/netframework-4.0/bb384200(v=vs.100)">Add-Ins and Extensibility</related>
</Docs>
<Members>
<Member MemberName="FullTrust">
Expand Down Expand Up @@ -86,11 +85,11 @@
<para>- It represents the maximum permission set a host can grant to its add-ins.<para></para>- It allows a ClickOnce or an Extensible Application Markup Language (XAML) Browser Application (XBAP) host to propagate its site of origin to its add-ins, which enables them to contact the server.</para>
</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
<format type="text/markdown"><![CDATA[

## Remarks


]]></format>
</remarks>
</Docs>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@
<format type="text/markdown"><![CDATA[

## Remarks
When an add-in is activated, its pipeline to the host is constructed. The add-in system requires that pipeline segments be placed in a specified directory structure with specified directory names, as described in [Pipeline Development Requirements](/previous-versions/dotnet/netframework-4.0/bb384240(v=vs.100)).
When an add-in is activated, its pipeline to the host is constructed. The add-in system requires that pipeline segments be placed in a specified directory structure with specified directory names.

]]></format>
</remarks>
Expand Down
1 change: 0 additions & 1 deletion xml/System.AddIn.Hosting/AddInStore.xml
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,6 @@

]]></format>
</remarks>
<related type="Article" href="/previous-versions/dotnet/netframework-4.0/bb384200(v=vs.100)">Add-Ins and Extensibility</related>
</Docs>
<Members>
<Member MemberName="FindAddIn">
Expand Down
3 changes: 0 additions & 3 deletions xml/System.AddIn.Hosting/AddInToken.xml
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,6 @@

]]></format>
</remarks>
<related type="Article" href="/previous-versions/dotnet/netframework-4.0/bb384200(v=vs.100)">Add-Ins and Extensibility</related>
</Docs>
<Members>
<MemberGroup MemberName="Activate&lt;T&gt;">
Expand Down Expand Up @@ -119,7 +118,6 @@

]]></format>
</remarks>
<related type="Article" href="/previous-versions/dotnet/netframework-4.0/bb384200(v=vs.100)">Add-Ins and Extensibility</related>
</Docs>
</Member>
<Member MemberName="Activate&lt;T&gt;">
Expand Down Expand Up @@ -167,7 +165,6 @@

]]></format>
</remarks>
<related type="Article" href="/previous-versions/dotnet/netframework-4.0/bb384200(v=vs.100)">Add-Ins and Extensibility</related>
</Docs>
</Member>
<Member MemberName="Activate&lt;T&gt;">
Expand Down
1 change: 0 additions & 1 deletion xml/System.AddIn.Pipeline/AddInAdapterAttribute.xml
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,6 @@

]]></format>
</remarks>
<related type="Article" href="/previous-versions/dotnet/netframework-4.0/bb384200(v=vs.100)">Add-Ins and Extensibility</related>
</Docs>
<Members>
<Member MemberName=".ctor">
Expand Down
1 change: 0 additions & 1 deletion xml/System.AddIn.Pipeline/AddInBaseAttribute.xml
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,6 @@

]]></format>
</remarks>
<related type="Article" href="/previous-versions/dotnet/netframework-4.0/bb384200(v=vs.100)">Add-Ins and Extensibility</related>
</Docs>
<Members>
<Member MemberName=".ctor">
Expand Down
1 change: 0 additions & 1 deletion xml/System.AddIn.Pipeline/AddInContractAttribute.xml
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,6 @@

]]></format>
</remarks>
<related type="Article" href="/previous-versions/dotnet/netframework-4.0/bb384200(v=vs.100)">Add-Ins and Extensibility</related>
</Docs>
<Members>
<Member MemberName=".ctor">
Expand Down
7 changes: 2 additions & 5 deletions xml/System.AddIn.Pipeline/CollectionAdapters.xml
Original file line number Diff line number Diff line change
Expand Up @@ -22,11 +22,10 @@
## Remarks
This class provides methods that enable an <xref:System.Collections.Generic.IList`1> collection to be converted to a <xref:System.AddIn.Contract.IListContract`1> collection. The <xref:System.AddIn.Contract.IListContract`1> collection is passed across the isolation boundary and converted back to an <xref:System.Collections.Generic.IList`1> collection that the add-in or the host application can use.

Objects in collections must be remotable. For more information about the object types that you can pass, see [Contracts, Views, and Adapters](/previous-versions/dotnet/netframework-4.0/bb384205(v=vs.100)).
Objects in collections must be remotable.

]]></format>
</remarks>
<related type="Article" href="/previous-versions/dotnet/netframework-4.0/bb384200(v=vs.100)">Add-Ins and Extensibility</related>
</Docs>
<Members>
<Member MemberName="ToIList&lt;T&gt;">
Expand Down Expand Up @@ -64,10 +63,8 @@

You should use this method overload only when the contents of the <xref:System.AddIn.Contract.IListContract`1> are serializable types that can be passed directly to the add-in and host (rather than types that must be adapted into views).



## Examples
The following example implements a host-side adapter pipeline segment as described [Walkthrough: Passing Collections Between Hosts and Add-Ins](/previous-versions/dotnet/netframework-4.0/bb384207(v=vs.100)). The example adapts the custom `ProcessBooks` method by taking the <xref:System.AddIn.Contract.IListContract`1> collection passed from the add-in and converting it to an <xref:System.Collections.Generic.IList`1> collection, which the host application can then use.
The following example implements a host-side adapter pipeline segment. The example adapts the custom `ProcessBooks` method by taking the <xref:System.AddIn.Contract.IListContract`1> collection passed from the add-in and converting it to an <xref:System.Collections.Generic.IList`1> collection, which the host application can then use.

:::code language="csharp" source="~/snippets/csharp/System.AddIn.Pipeline/CollectionAdapters/ToIListT/LibraryManagerViewToContractAddInAdapter.cs" id="Snippet3":::
:::code language="vb" source="~/snippets/visualbasic/System.AddIn.Pipeline/CollectionAdapters/ToIListT/LibraryManagerViewToContractAddInAdapter.vb" id="Snippet3":::
Expand Down
41 changes: 20 additions & 21 deletions xml/System.AddIn.Pipeline/ContractBase.xml
Original file line number Diff line number Diff line change
Expand Up @@ -24,14 +24,13 @@
<Docs>
<summary>Provides a default implementation of <see cref="T:System.AddIn.Contract.IContract" /> members.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
Contracts define the types and methods used by the host and the add-in. All contracts must derive from <xref:System.AddIn.Contract.IContract>. This class provides the default implementation of <xref:System.AddIn.Contract.IContract> members.
<format type="text/markdown"><![CDATA[

## Remarks
Contracts define the types and methods used by the host and the add-in. All contracts must derive from <xref:System.AddIn.Contract.IContract>. This class provides the default implementation of <xref:System.AddIn.Contract.IContract> members.

]]></format>
</remarks>
<related type="Article" href="/previous-versions/dotnet/netframework-4.0/bb384200(v=vs.100)">Add-Ins and Extensibility</related>
</Docs>
<Members>
<Member MemberName=".ctor">
Expand Down Expand Up @@ -125,11 +124,11 @@
<Docs>
<summary>When overridden in an add-in-side adapter, releases native resources held by the adapter.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
This method is called by the system when all the lifetime tokens that have been acquired from the current <xref:System.AddIn.Pipeline.ContractBase> instance have been revoked. Use this method to clean up any native resources held by the adapter, and to signal to the adapted views that they should do the same.
<format type="text/markdown"><![CDATA[

## Remarks
This method is called by the system when all the lifetime tokens that have been acquired from the current <xref:System.AddIn.Pipeline.ContractBase> instance have been revoked. Use this method to clean up any native resources held by the adapter, and to signal to the adapted views that they should do the same.

]]></format>
</remarks>
</Docs>
Expand Down Expand Up @@ -161,11 +160,11 @@
<summary>Reflects over the instance of a contract and returns the <see langword="this" /> pointer if the current object implements that contract.</summary>
<returns>The <see langword="this" /> pointer to an <see cref="T:System.AddIn.Contract.IContract" /> interface, or <see langword="null" /> if the contract is not implemented.</returns>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
This method can be overridden.
<format type="text/markdown"><![CDATA[

## Remarks
This method can be overridden.

]]></format>
</remarks>
<exception cref="T:System.ArgumentNullException">
Expand Down Expand Up @@ -305,11 +304,11 @@
<param name="token">The token number.</param>
<summary>Removes the specified token from the list of outstanding lifetime tokens.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
If the token is not in the list of outstanding lifetime tokens, this method throws an <xref:System.InvalidOperationException>.
<format type="text/markdown"><![CDATA[

## Remarks
If the token is not in the list of outstanding lifetime tokens, this method throws an <xref:System.InvalidOperationException>.

]]></format>
</remarks>
<exception cref="T:System.InvalidOperationException">
Expand Down
1 change: 0 additions & 1 deletion xml/System.AddIn.Pipeline/FrameworkElementAdapters.xml
Original file line number Diff line number Diff line change
Expand Up @@ -105,7 +105,6 @@ Windows Presentation Foundation (WPF) extends the .NET Framework add-in model to
<exception cref="T:System.InvalidOperationException">
<paramref name="root" /> is not the root element of a tree of elements.</exception>
<altmember cref="M:System.AddIn.Pipeline.FrameworkElementAdapters.ContractToViewAdapter(System.AddIn.Contract.INativeHandleContract)" />
<related type="Article" href="https://learn.microsoft.com/previous-versions/dotnet/netframework-3.5/bb913905(v=vs.90)">WPF Add-In has Multiple UIs Sample</related>
</Docs>
</Member>
</Members>
Expand Down
1 change: 0 additions & 1 deletion xml/System.AddIn.Pipeline/HostAdapterAttribute.xml
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,6 @@

]]></format>
</remarks>
<related type="Article" href="/previous-versions/dotnet/netframework-4.0/bb384200(v=vs.100)">Add-Ins and Extensibility</related>
</Docs>
<Members>
<Member MemberName=".ctor">
Expand Down
1 change: 0 additions & 1 deletion xml/System.AddIn/AddInAttribute.xml
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,6 @@

]]></format>
</remarks>
<related type="Article" href="/previous-versions/dotnet/netframework-4.0/bb384200(v=vs.100)">Add-Ins and Extensibility</related>
</Docs>
<Members>
<Member MemberName=".ctor">
Expand Down
Loading
Loading