File: EndpointDispatcher.xml

package info (click to toggle)
mono 6.12.0.199%2Bdfsg-6
  • links: PTS, VCS
  • area: main
  • in suites: sid, trixie
  • size: 1,296,836 kB
  • sloc: cs: 11,181,803; xml: 2,850,076; ansic: 699,709; cpp: 123,344; perl: 59,361; javascript: 30,841; asm: 21,853; makefile: 20,405; sh: 15,009; python: 4,839; pascal: 925; sql: 859; sed: 16; php: 1
file content (271 lines) | stat: -rw-r--r-- 19,510 bytes parent folder | download | duplicates (10)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
<?xml version="1.0" encoding="utf-8"?>
<Type Name="EndpointDispatcher" FullName="System.ServiceModel.Dispatcher.EndpointDispatcher">
  <TypeSignature Language="C#" Value="public class EndpointDispatcher" />
  <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit EndpointDispatcher extends System.Object" />
  <AssemblyInfo>
    <AssemblyName>System.ServiceModel</AssemblyName>
    <AssemblyVersion>4.0.0.0</AssemblyVersion>
  </AssemblyInfo>
  <Base>
    <BaseTypeName>System.Object</BaseTypeName>
  </Base>
  <Interfaces />
  <Docs>
    <remarks>
      <attribution license="cc4" from="Microsoft" modified="false" />
      <para>The <see cref="T:System.ServiceModel.Dispatcher.EndpointDispatcher" /> and the <see cref="T:System.ServiceModel.Dispatcher.DispatchRuntime" /> classes expose the runtime customization points for endpoints in a service. The <see cref="T:System.ServiceModel.Dispatcher.EndpointDispatcher" /> can be used to control which messages it can process and some endpoint-related information. The <see cref="T:System.ServiceModel.Dispatcher.DispatchRuntime" /> has a large number of properties used to insert custom extensions into the endpoint-wide runtime.</para>
      <para>The <see cref="T:System.ServiceModel.Dispatcher.EndpointDispatcher" /> object is responsible for processing messages from a <see cref="T:System.ServiceModel.Dispatcher.ChannelDispatcher" /> when the destination address of a message matches the <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.AddressFilter" /> property and the message action matches the <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.ContractFilter" /> property. If two <see cref="T:System.ServiceModel.Dispatcher.EndpointDispatcher" /> objects can accept a message, the <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.FilterPriority" /> property value determines the higher priority endpoint.</para>
      <para>Use the <see cref="T:System.ServiceModel.Dispatcher.EndpointDispatcher" /> object to configure or extend the process of receiving messages from the associated <see cref="T:System.ServiceModel.Dispatcher.ChannelDispatcher" />, converting from message objects to objects used as parameters, and invoking an endpoint operation as well as the reverse process.</para>
      <para>Typically, the <see cref="T:System.ServiceModel.Dispatcher.EndpointDispatcher" /> for an endpoint is obtained by implementing the <see cref="T:System.ServiceModel.Description.IEndpointBehavior" /> interface, but you can access the <see cref="T:System.ServiceModel.Dispatcher.EndpointDispatcher" /> from the other behavior interfaces.</para>
      <para>You can use the following <see cref="T:System.ServiceModel.Dispatcher.EndpointDispatcher" /> properties:</para>
      <list type="bullet">
        <item>
          <para>The <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.AddressFilter" /> property allows you to get or set a <see cref="T:System.ServiceModel.Dispatcher.MessageFilter" /> object that the <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.ChannelDispatcher" /> uses to identify whether the endpoint can process a particular message.</para>
        </item>
        <item>
          <para>The <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.ChannelDispatcher" /> property gets the associated <see cref="T:System.ServiceModel.Dispatcher.ChannelDispatcher" /> object, which sends and receives messages to and from the <see cref="T:System.ServiceModel.Dispatcher.EndpointDispatcher" /> and which can be used to inspect or modify other channel-related values and behaviors.</para>
        </item>
        <item>
          <para>The <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.ContractFilter" /> gets the <see cref="T:System.ServiceModel.Dispatcher.MessageFilter" /> object that is used to identify whether a message is destined for this contract.</para>
        </item>
        <item>
          <para>The <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.ContractName" /> and <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.ContractNamespace" /> properties return the name and namespace of the endpoint contract.</para>
        </item>
        <item>
          <para>The <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.DispatchRuntime" /> property returns the <see cref="T:System.ServiceModel.Dispatcher.DispatchRuntime" /> object that you can use to modify run-time values or insert custom run-time extensions for the entire endpoint.</para>
        </item>
        <item>
          <para>The <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.EndpointAddress" /> property gets the address of the endpoint.</para>
        </item>
        <item>
          <para>The <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.FilterPriority" /> property returns the priority of the composite filter that the <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.ChannelDispatcher" /> uses to establish which endpoint is to handle the message.</para>
        </item>
      </list>
    </remarks>
    <summary>
      <attribution license="cc4" from="Microsoft" modified="false" />
      <para>Represents the run-time object that exposes properties that enable the insertion of run-time extensions or modifications for messages in service applications.</para>
    </summary>
  </Docs>
  <Members>
    <Member MemberName=".ctor">
      <MemberSignature Language="C#" Value="public EndpointDispatcher (System.ServiceModel.EndpointAddress address, string contractName, string contractNamespace);" />
      <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.ServiceModel.EndpointAddress address, string contractName, string contractNamespace) cil managed" />
      <MemberType>Constructor</MemberType>
      <AssemblyInfo>
        <AssemblyVersion>4.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <Parameters>
        <Parameter Name="address" Type="System.ServiceModel.EndpointAddress" />
        <Parameter Name="contractName" Type="System.String" />
        <Parameter Name="contractNamespace" Type="System.String" />
      </Parameters>
      <Docs>
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Use this constructor to create an endpoint that is not in the description.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Initializes a new instance of the <see cref="T:System.ServiceModel.Dispatcher.EndpointDispatcher" /> class with the specified address, contract name, and contract namespace.</para>
        </summary>
        <param name="address">
          <attribution license="cc4" from="Microsoft" modified="false" />The endpoint address.</param>
        <param name="contractName">
          <attribution license="cc4" from="Microsoft" modified="false" />The name of the endpoint contract.</param>
        <param name="contractNamespace">
          <attribution license="cc4" from="Microsoft" modified="false" />The namespace of the endpoint contract.</param>
      </Docs>
    </Member>
    <Member MemberName="AddressFilter">
      <MemberSignature Language="C#" Value="public System.ServiceModel.Dispatcher.MessageFilter AddressFilter { get; set; }" />
      <MemberSignature Language="ILAsm" Value=".property instance class System.ServiceModel.Dispatcher.MessageFilter AddressFilter" />
      <MemberType>Property</MemberType>
      <AssemblyInfo>
        <AssemblyVersion>4.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <ReturnValue>
        <ReturnType>System.ServiceModel.Dispatcher.MessageFilter</ReturnType>
      </ReturnValue>
      <Docs>
        <value>To be added.</value>
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>The <see cref="T:System.ServiceModel.Dispatcher.ChannelDispatcher" /> has an <see cref="T:System.ServiceModel.Dispatcher.EndpointDispatcher" /> for each endpoint the channel can support. The <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.AddressFilter" /> property is a <see cref="T:System.ServiceModel.Dispatcher.MessageFilter" /> object that matches the destination endpoint address of the message. The <see cref="T:System.ServiceModel.Dispatcher.ChannelDispatcher" /> combines the <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.AddressFilter" /> value with the <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.ContractFilter" /> value to determine whether to route a message to this endpoint.</para>
          <para>In the case where two <see cref="T:System.ServiceModel.Dispatcher.EndpointDispatcher" /> objects that match can process a message, the <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.FilterPriority" /> property is used to select an endpoint.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets a <see cref="T:System.ServiceModel.Dispatcher.MessageFilter" /> object that is used to identify whether a particular message is destined for the endpoint address.</para>
        </summary>
      </Docs>
    </Member>
    <Member MemberName="ChannelDispatcher">
      <MemberSignature Language="C#" Value="public System.ServiceModel.Dispatcher.ChannelDispatcher ChannelDispatcher { get; }" />
      <MemberSignature Language="ILAsm" Value=".property instance class System.ServiceModel.Dispatcher.ChannelDispatcher ChannelDispatcher" />
      <MemberType>Property</MemberType>
      <AssemblyInfo>
        <AssemblyVersion>4.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <ReturnValue>
        <ReturnType>System.ServiceModel.Dispatcher.ChannelDispatcher</ReturnType>
      </ReturnValue>
      <Docs>
        <value>To be added.</value>
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>The <see cref="T:System.ServiceModel.Dispatcher.ChannelDispatcher" /> object receives a message from a channel and uses the <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.AddressFilter" />, <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.ContractFilter" />, and <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.FilterPriority" /> properties to determine by which endpoint the message is processed.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets the associated <see cref="T:System.ServiceModel.Dispatcher.ChannelDispatcher" /> object, which can be used to inspect or modify other channel-related values and behaviors.</para>
        </summary>
      </Docs>
    </Member>
    <Member MemberName="ContractFilter">
      <MemberSignature Language="C#" Value="public System.ServiceModel.Dispatcher.MessageFilter ContractFilter { get; set; }" />
      <MemberSignature Language="ILAsm" Value=".property instance class System.ServiceModel.Dispatcher.MessageFilter ContractFilter" />
      <MemberType>Property</MemberType>
      <AssemblyInfo>
        <AssemblyVersion>4.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <ReturnValue>
        <ReturnType>System.ServiceModel.Dispatcher.MessageFilter</ReturnType>
      </ReturnValue>
      <Docs>
        <value>To be added.</value>
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>The <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.ContractFilter" /> property is a <see cref="T:System.ServiceModel.Dispatcher.MessageFilter" /> object that is matched against the action of a message. The <see cref="T:System.ServiceModel.Dispatcher.ChannelDispatcher" /> combines the <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.AddressFilter" /> value with the <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.ContractFilter" /> value to determine whether to route a message to this endpoint.</para>
          <para>In the case where two <see cref="T:System.ServiceModel.Dispatcher.EndpointDispatcher" /> objects that match can process a message, the <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.FilterPriority" /> property is used to select an endpoint.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets the <see cref="T:System.ServiceModel.Dispatcher.MessageFilter" /> object that is used to identify whether a message is destined for this contract.</para>
        </summary>
      </Docs>
    </Member>
    <Member MemberName="ContractName">
      <MemberSignature Language="C#" Value="public string ContractName { get; }" />
      <MemberSignature Language="ILAsm" Value=".property instance string ContractName" />
      <MemberType>Property</MemberType>
      <AssemblyInfo>
        <AssemblyVersion>4.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <ReturnValue>
        <ReturnType>System.String</ReturnType>
      </ReturnValue>
      <Docs>
        <value>To be added.</value>
        <remarks>To be added.</remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets the endpoint contract name.</para>
        </summary>
      </Docs>
    </Member>
    <Member MemberName="ContractNamespace">
      <MemberSignature Language="C#" Value="public string ContractNamespace { get; }" />
      <MemberSignature Language="ILAsm" Value=".property instance string ContractNamespace" />
      <MemberType>Property</MemberType>
      <AssemblyInfo>
        <AssemblyVersion>4.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <ReturnValue>
        <ReturnType>System.String</ReturnType>
      </ReturnValue>
      <Docs>
        <value>To be added.</value>
        <remarks>To be added.</remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets the namespace of the endpoint contract.</para>
        </summary>
      </Docs>
    </Member>
    <Member MemberName="DispatchRuntime">
      <MemberSignature Language="C#" Value="public System.ServiceModel.Dispatcher.DispatchRuntime DispatchRuntime { get; }" />
      <MemberSignature Language="ILAsm" Value=".property instance class System.ServiceModel.Dispatcher.DispatchRuntime DispatchRuntime" />
      <MemberType>Property</MemberType>
      <AssemblyInfo>
        <AssemblyVersion>4.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <ReturnValue>
        <ReturnType>System.ServiceModel.Dispatcher.DispatchRuntime</ReturnType>
      </ReturnValue>
      <Docs>
        <value>To be added.</value>
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Use the <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.DispatchRuntime" /> property to obtain the <see cref="T:System.ServiceModel.Dispatcher.DispatchRuntime" /> object to modify run-time values or insert custom run-time extensions for the entire endpoint. From the <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.DispatchRuntime" /> property, you can also navigate to the <see cref="T:System.ServiceModel.Dispatcher.DispatchOperation" /> collection for the endpoint.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets the <see cref="T:System.ServiceModel.Dispatcher.DispatchRuntime" /> object used to inspect, modify, or extend run-time behavior across a service endpoint or a client callback endpoint.</para>
        </summary>
      </Docs>
    </Member>
    <Member MemberName="EndpointAddress">
      <MemberSignature Language="C#" Value="public System.ServiceModel.EndpointAddress EndpointAddress { get; }" />
      <MemberSignature Language="ILAsm" Value=".property instance class System.ServiceModel.EndpointAddress EndpointAddress" />
      <MemberType>Property</MemberType>
      <AssemblyInfo>
        <AssemblyVersion>4.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <ReturnValue>
        <ReturnType>System.ServiceModel.EndpointAddress</ReturnType>
      </ReturnValue>
      <Docs>
        <value>To be added.</value>
        <remarks>To be added.</remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets the address of the endpoint.</para>
        </summary>
      </Docs>
    </Member>
    <Member MemberName="FilterPriority">
      <MemberSignature Language="C#" Value="public int FilterPriority { get; set; }" />
      <MemberSignature Language="ILAsm" Value=".property instance int32 FilterPriority" />
      <MemberType>Property</MemberType>
      <AssemblyInfo>
        <AssemblyVersion>4.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <ReturnValue>
        <ReturnType>System.Int32</ReturnType>
      </ReturnValue>
      <Docs>
        <value>To be added.</value>
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>The <see cref="T:System.ServiceModel.Dispatcher.ChannelDispatcher" /> combines the <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.AddressFilter" /> value with the <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.ContractFilter" /> value to determine whether to route a message to this endpoint.</para>
          <para>In the case where two <see cref="T:System.ServiceModel.Dispatcher.EndpointDispatcher" /> objects that match can process a message, the <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.FilterPriority" /> property is used to select an endpoint.</para>
          <para>If two endpoints can process a message and the value of their <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.FilterPriority" /> property matches, a <see cref="T:System.ServiceModel.Dispatcher.MultipleFilterMatchesException" /> is thrown.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets the priority of the <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.ContractFilter" /> and the <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.AddressFilter" /> combination when the <see cref="P:System.ServiceModel.Dispatcher.EndpointDispatcher.ChannelDispatcher" /> is selecting endpoints.</para>
        </summary>
      </Docs>
    </Member>
    <Member MemberName="IsSystemEndpoint">
      <MemberSignature Language="C#" Value="public bool IsSystemEndpoint { get; }" />
      <MemberSignature Language="ILAsm" Value=".property instance bool IsSystemEndpoint" />
      <MemberType>Property</MemberType>
      <AssemblyInfo>
        <AssemblyVersion>4.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <ReturnValue>
        <ReturnType>System.Boolean</ReturnType>
      </ReturnValue>
      <Docs>
        <value>To be added.</value>
        <remarks>To be added.</remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets a value that indicates whether the endpoint is created internally by the server and not by the user.</para>
        </summary>
      </Docs>
    </Member>
  </Members>
</Type>