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
  •  
  •  
  •  
74 changes: 37 additions & 37 deletions xml/System.ServiceModel.Activation/ServiceHostFactory.xml
Original file line number Diff line number Diff line change
Expand Up @@ -29,23 +29,23 @@
<Docs>
<summary>Factory that provides instances of <see cref="T:System.ServiceModel.ServiceHost" /> in managed hosting environments where the host instance is created dynamically in response to incoming messages.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
The managed hosting environments that support dynamic activation are Internet Information Services (IIS) and Windows Process Activation Service (WAS).
If you have implemented a custom derivative of <xref:System.ServiceModel.ServiceHost>, consider also implementing a factory that derives from the <xref:System.ServiceModel.Activation.ServiceHostFactory> class.
If you have implemented a custom derivative of <xref:System.ServiceModel.ServiceHostBase> instead, then consider also implementing a factory that derives your factory from <xref:System.ServiceModel.Activation.ServiceHostFactoryBase> directly.
## Examples
This examples show how to use the <xref:System.ServiceModel.Activation.ServiceHostFactory> class:
<format type="text/markdown"><![CDATA[

## Remarks
The managed hosting environments that support dynamic activation are Internet Information Services (IIS) and Windows Process Activation Service (WAS).

If you have implemented a custom derivative of <xref:System.ServiceModel.ServiceHost>, consider also implementing a factory that derives from the <xref:System.ServiceModel.Activation.ServiceHostFactory> class.

If you have implemented a custom derivative of <xref:System.ServiceModel.ServiceHostBase> instead, then consider also implementing a factory that derives your factory from <xref:System.ServiceModel.Activation.ServiceHostFactoryBase> directly.



## Examples
This examples show how to use the <xref:System.ServiceModel.Activation.ServiceHostFactory> class:

:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/servicehostfactory/cs/program.cs" id="Snippet0":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/servicehostfactory/vb/program.vb" id="Snippet0":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/servicehostfactory/vb/program.vb" id="Snippet0":::

]]></format>
</remarks>
</Docs>
Expand All @@ -69,14 +69,14 @@
<Docs>
<summary>Initializes a new instance of the <see cref="T:System.ServiceModel.Activation.ServiceHostFactory" /> class.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Examples
This examples show how to use the <xref:System.ServiceModel.Activation.ServiceHostFactory.%23ctor%2A>:
<format type="text/markdown"><![CDATA[

## Examples
This examples show how to use the <xref:System.ServiceModel.Activation.ServiceHostFactory.%23ctor*>:

:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/servicehostfactory/cs/program.cs" id="Snippet1":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/servicehostfactory/vb/program.vb" id="Snippet1":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/servicehostfactory/vb/program.vb" id="Snippet1":::

]]></format>
</remarks>
</Docs>
Expand Down Expand Up @@ -119,14 +119,14 @@
<summary>Creates a <see cref="T:System.ServiceModel.ServiceHost" /> with specific base addresses and initializes it with specified data.</summary>
<returns>A <see cref="T:System.ServiceModel.ServiceHost" /> with specific base addresses.</returns>
<remarks>
<format type="text/markdown"><![CDATA[
## Examples
This example shows how to use the <xref:System.ServiceModel.Activation.ServiceHostFactory.CreateServiceHost%28System.String%2CSystem.Uri%5B%5D%29> method:
<format type="text/markdown"><![CDATA[

## Examples
This example shows how to use the <xref:System.ServiceModel.Activation.ServiceHostFactory.CreateServiceHost(System.String,System.Uri[])> method:

:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/servicehostfactory/cs/program.cs" id="Snippet3":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/servicehostfactory/vb/program.vb" id="Snippet3":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/servicehostfactory/vb/program.vb" id="Snippet3":::

]]></format>
</remarks>
<exception cref="T:System.ArgumentNullException">
Expand Down Expand Up @@ -163,13 +163,13 @@
<summary>Creates a <see cref="T:System.ServiceModel.ServiceHost" /> for a specified type of service with a specific base address.</summary>
<returns>A <see cref="T:System.ServiceModel.ServiceHost" /> for the type of service specified with a specific base address.</returns>
<remarks>
<format type="text/markdown"><![CDATA[
## Examples
This example shows how to create an override implementation of the <xref:System.ServiceModel.Activation.ServiceHostFactory.CreateServiceHost%28System.Type%2CSystem.Uri%5B%5D%29> method:
<format type="text/markdown"><![CDATA[

## Examples
This example shows how to create an override implementation of the <xref:System.ServiceModel.Activation.ServiceHostFactory.CreateServiceHost(System.Type,System.Uri[])> method:



]]></format>
</remarks>
</Docs>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -67,11 +67,11 @@
<value>
<see langword="true" /> if the workflow instance cache is turned on; otherwise, <see langword="false" />.</value>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
In the majority of the cases when there are no custom bindings and/or behaviors, we turn on cache by default. In the case where the user did plug in their own binding and behaviors, the caching of the channel factories could become unsecure, therefore, we turn off our cache by default. But the user can set the <xref:System.ServiceModel.Activities.Configuration.SendMessageChannelCacheElement.AllowUnsafeCaching> back on which requires them to carefully read the appropriate MSDN document and make a decision that strikes a balance between security and performance.
<format type="text/markdown"><![CDATA[

## Remarks
In the majority of the cases when there are no custom bindings and/or behaviors, we turn on cache by default. In the case where the user did plug in their own binding and behaviors, the caching of the channel factories could become unsecure, therefore, we turn off our cache by default. But the user can set the <xref:System.ServiceModel.Activities.Configuration.SendMessageChannelCacheElement.AllowUnsafeCaching> back on which requires them to carefully read the appropriate MSDN document and make a decision that strikes a balance between security and performance.

]]></format>
</remarks>
</Docs>
Expand Down Expand Up @@ -171,11 +171,11 @@
<summary>Gets or sets the settings of the channel factory cache.</summary>
<value>The settings of the channel factory cache.</value>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
The channel factory cache represents cached channel factories. For more information about channel factories, see <xref:System.ServiceModel.ChannelFactory> and <xref:System.ServiceModel.ChannelFactory%601>.
<format type="text/markdown"><![CDATA[

## Remarks
The channel factory cache represents cached channel factories. For more information about channel factories, see <xref:System.ServiceModel.ChannelFactory> and <xref:System.ServiceModel.ChannelFactory`1>.

]]></format>
</remarks>
</Docs>
Expand Down
28 changes: 14 additions & 14 deletions xml/System.ServiceModel.Activities/ReceiveContent.xml
Original file line number Diff line number Diff line change
Expand Up @@ -16,13 +16,13 @@
<Docs>
<summary>An abstract base class for classes that represent the data received by a workflow service.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Examples
The following example shows how to use the <xref:System.ServiceModel.Activities.ReceiveContent> class to specify the content for a <xref:System.ServiceModel.Activities.Receive> activity.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/contentbasedcorrelation/cs/client.cs" id="Snippet3":::
<format type="text/markdown"><![CDATA[

## Examples
The following example shows how to use the <xref:System.ServiceModel.Activities.ReceiveContent> class to specify the content for a <xref:System.ServiceModel.Activities.Receive> activity.

:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/contentbasedcorrelation/cs/client.cs" id="Snippet3":::

]]></format>
</remarks>
</Docs>
Expand Down Expand Up @@ -59,13 +59,13 @@
<summary>Creates a new <see cref="T:System.ServiceModel.Activities.ReceiveMessageContent" /> instance with the specified message.</summary>
<returns>A <see cref="T:System.ServiceModel.Activities.ReceiveMessageContent" /> instance.</returns>
<remarks>
<format type="text/markdown"><![CDATA[
## Examples
The following example shows how to use the <xref:System.ServiceModel.Activities.ReceiveContent.Create%2A> method to specify the content for a <xref:System.ServiceModel.Activities.Receive> activity.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/contentbasedcorrelation/cs/client.cs" id="Snippet3":::
<format type="text/markdown"><![CDATA[

## Examples
The following example shows how to use the <xref:System.ServiceModel.Activities.ReceiveContent.Create*> method to specify the content for a <xref:System.ServiceModel.Activities.Receive> activity.

:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/contentbasedcorrelation/cs/client.cs" id="Snippet3":::

]]></format>
</remarks>
</Docs>
Expand Down
94 changes: 47 additions & 47 deletions xml/System.ServiceModel.Activities/SendMessageChannelCache.xml
Original file line number Diff line number Diff line change
Expand Up @@ -20,22 +20,22 @@
<Docs>
<summary>Represents an extension that enables the customization of the cache sharing levels, the settings of the channel factory cache, and the settings of the channel cache for workflows that send messages to service endpoints using <see cref="T:System.ServiceModel.Activities.Send" /> messaging activities.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
This class is intended for workflows that send messages to service endpoints. These workflows are typically client workflows but could also be workflow services that are hosted in a <xref:System.ServiceModel.WorkflowServiceHost>.
By default, in a workflow hosted by a <xref:System.ServiceModel.WorkflowServiceHost>, the cache used by <xref:System.ServiceModel.Activities.Send> messaging activities is shared across all workflow instances in the <xref:System.ServiceModel.WorkflowServiceHost> (host-level caching). For a client workflow that is not hosted by a <xref:System.ServiceModel.WorkflowServiceHost>, the cache is available only to the workflow instance (instance-level caching). Caching is disabled by default for any send activity in your workflow that has endpoints defined in configuration.
For more information about how to change the default cache sharing levels and cache settings for the channel factory and channel cache, see [Changing the Cache Sharing Levels for Send Activities](/dotnet/framework/wcf/feature-details/changing-the-cache-sharing-levels-for-send-activities).
## Examples
The following example shows how to use the <xref:System.ServiceModel.Activities.SendMessageChannelCache> class to share a channel cache between two workflow applications in a single app domain.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/channelcache/cs/client.cs" id="Snippet0":::
<format type="text/markdown"><![CDATA[

## Remarks
This class is intended for workflows that send messages to service endpoints. These workflows are typically client workflows but could also be workflow services that are hosted in a <xref:System.ServiceModel.WorkflowServiceHost>.

By default, in a workflow hosted by a <xref:System.ServiceModel.WorkflowServiceHost>, the cache used by <xref:System.ServiceModel.Activities.Send> messaging activities is shared across all workflow instances in the <xref:System.ServiceModel.WorkflowServiceHost> (host-level caching). For a client workflow that is not hosted by a <xref:System.ServiceModel.WorkflowServiceHost>, the cache is available only to the workflow instance (instance-level caching). Caching is disabled by default for any send activity in your workflow that has endpoints defined in configuration.

For more information about how to change the default cache sharing levels and cache settings for the channel factory and channel cache, see [Changing the Cache Sharing Levels for Send Activities](/dotnet/framework/wcf/feature-details/changing-the-cache-sharing-levels-for-send-activities).



## Examples
The following example shows how to use the <xref:System.ServiceModel.Activities.SendMessageChannelCache> class to share a channel cache between two workflow applications in a single app domain.

:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/channelcache/cs/client.cs" id="Snippet0":::

]]></format>
</remarks>
</Docs>
Expand Down Expand Up @@ -99,20 +99,20 @@
<param name="channelSettings">The cache settings for cached channels.</param>
<summary>Initializes a new instance of the <see cref="T:System.ServiceModel.Activities.SendMessageChannelCache" /> class with custom factory cache and channel cache settings.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
For more information about channel factories, see <xref:System.ServiceModel.ChannelFactory> and <xref:System.ServiceModel.ChannelFactory%601>.
You can choose to use only the channel factory cache and disable the channel cache by passing the `channelSettings` parameter to this constructor initialized to a <xref:System.ServiceModel.Activities.ChannelCacheSettings> instance with a <xref:System.ServiceModel.Activities.ChannelCacheSettings.MaxItemsInCache> value of 0. To disable the cache completely for both the channel factory cache and the channel cache, pass the `factorySettings` parameter to this constructor initialized to a <xref:System.ServiceModel.Activities.ChannelCacheSettings> instance with a <xref:System.ServiceModel.Activities.ChannelCacheSettings.MaxItemsInCache> value of 0. Note that you cannot turn the channel cache on if the channel factory cache is disabled.
## Examples
The following example shows how to use the <xref:System.ServiceModel.Activities.SendMessageChannelCache> class to share a channel cache between two workflow applications in a single app domain.
:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/channelcache/cs/client.cs" id="Snippet0":::
<format type="text/markdown"><![CDATA[

## Remarks
For more information about channel factories, see <xref:System.ServiceModel.ChannelFactory> and <xref:System.ServiceModel.ChannelFactory`1>.

You can choose to use only the channel factory cache and disable the channel cache by passing the `channelSettings` parameter to this constructor initialized to a <xref:System.ServiceModel.Activities.ChannelCacheSettings> instance with a <xref:System.ServiceModel.Activities.ChannelCacheSettings.MaxItemsInCache> value of 0. To disable the cache completely for both the channel factory cache and the channel cache, pass the `factorySettings` parameter to this constructor initialized to a <xref:System.ServiceModel.Activities.ChannelCacheSettings> instance with a <xref:System.ServiceModel.Activities.ChannelCacheSettings.MaxItemsInCache> value of 0. Note that you cannot turn the channel cache on if the channel factory cache is disabled.



## Examples
The following example shows how to use the <xref:System.ServiceModel.Activities.SendMessageChannelCache> class to share a channel cache between two workflow applications in a single app domain.

:::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/channelcache/cs/client.cs" id="Snippet0":::

]]></format>
</remarks>
</Docs>
Expand Down Expand Up @@ -141,13 +141,13 @@
<see langword="true" /> to turn caching on; otherwise, <see langword="false" />.</param>
<summary>Initializes a new instance of the <see cref="T:System.ServiceModel.Activities.SendMessageChannelCache" /> class with custom factory cache settings, custom channel cache settings, and a value that indicates whether to turn caching on.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
By default, the cache is only available for <xref:System.ServiceModel.Activities.Send> activities that don't use endpoints defined in configuration. However, if you want to turn caching on in this case call this constructor with the `allowUnsafeCaching` parameter set to `true`. Next, add the new instance of this class as an extension to a workflow service host or a workflow instance.
For more information about channel factories, see <xref:System.ServiceModel.ChannelFactory> and <xref:System.ServiceModel.ChannelFactory%601>.
<format type="text/markdown"><![CDATA[

## Remarks
By default, the cache is only available for <xref:System.ServiceModel.Activities.Send> activities that don't use endpoints defined in configuration. However, if you want to turn caching on in this case call this constructor with the `allowUnsafeCaching` parameter set to `true`. Next, add the new instance of this class as an extension to a workflow service host or a workflow instance.

For more information about channel factories, see <xref:System.ServiceModel.ChannelFactory> and <xref:System.ServiceModel.ChannelFactory`1>.

]]></format>
</remarks>
</Docs>
Expand Down Expand Up @@ -178,11 +178,11 @@
<value>
<see langword="true" /> to turn caching on; otherwise, <see langword="false" />.</value>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
If the <xref:System.ServiceModel.Activities.Send> activity in your workflow has endpoints defined in configuration caching could be unsecure and therefore is disabled by default. However, if you want to turn caching on set this property to `true`.
<format type="text/markdown"><![CDATA[

## Remarks
If the <xref:System.ServiceModel.Activities.Send> activity in your workflow has endpoints defined in configuration caching could be unsecure and therefore is disabled by default. However, if you want to turn caching on set this property to `true`.

]]></format>
</remarks>
</Docs>
Expand Down Expand Up @@ -263,11 +263,11 @@
<summary>Gets or sets the settings of the channel factory cache.</summary>
<value>The settings of the channel factory cache.</value>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
The channel factory cache represents cached channel factories. For more information about channel factories, see <xref:System.ServiceModel.ChannelFactory> and <xref:System.ServiceModel.ChannelFactory%601>.
<format type="text/markdown"><![CDATA[

## Remarks
The channel factory cache represents cached channel factories. For more information about channel factories, see <xref:System.ServiceModel.ChannelFactory> and <xref:System.ServiceModel.ChannelFactory`1>.

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