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
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
|
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CustomBinding" FullName="System.ServiceModel.Channels.CustomBinding">
<TypeSignature Language="C#" Value="public class CustomBinding : System.ServiceModel.Channels.Binding" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit CustomBinding extends System.ServiceModel.Channels.Binding" />
<AssemblyInfo>
<AssemblyName>System.ServiceModel</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.ServiceModel.Channels.Binding</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use a custom binding when one of the system-provided bindings does not meet the requirements of your service. A custom binding could be used, for example, to enable the use of a new transport or a new encoder at a service endpoint. </para>
<para>A custom binding is constructed using one of the <see cref="Overload:System.ServiceModel.Channels.CustomBinding.#ctor" /> from a collection of binding elements that are "stacked" in a specific order:</para>
<list type="bullet">
<item>
<para>At the top is an optional <see cref="T:System.ServiceModel.Channels.TransactionFlowBindingElement" /> that allows flowing transactions.</para>
</item>
<item>
<para>Next is an optional <see cref="T:System.ServiceModel.Channels.ReliableSessionBindingElement" /> that provides a session and ordering mechanism as defined in the WS-ReliableMessaging specification. This notion of a session can cross SOAP and transport intermediaries.</para>
</item>
<item>
<para>Next is an optional security binding element that provides security features like authorization, authentication, protection, and confidentiality. The following security binding elements are provided by indigo1:</para>
<list type="bullet">
<item>
<para>
<see cref="T:System.ServiceModel.Channels.SecurityBindingElement" /> </para>
</item>
<item>
<para>
<see cref="T:System.ServiceModel.Channels.AsymmetricSecurityBindingElement" /> </para>
</item>
<item>
<para>
<see cref="T:System.ServiceModel.Channels.SymmetricSecurityBindingElement" />
</para>
</item>
<item>
<para>
<see cref="T:System.ServiceModel.Channels.TransportSecurityBindingElement" /> </para>
</item>
</list>
</item>
<item>
<para>Next are the optional message-patterns specified by binding elements:</para>
</item>
<item>
<para>
<see cref="T:System.ServiceModel.Channels.CompositeDuplexBindingElement" />
</para>
</item>
<item>
<para>Next are the optional transport upgrades/helpers binding elements: </para>
<list type="bullet">
<item>
<para>
<see cref="T:System.ServiceModel.Channels.PnrpPeerResolverBindingElement" />
</para>
</item>
<item>
<para>
<see cref="T:System.ServiceModel.Channels.SslStreamSecurityBindingElement" />
</para>
</item>
<item>
<para>
<see cref="T:System.ServiceModel.Channels.WindowsStreamSecurityBindingElement" />
</para>
</item>
</list>
</item>
<item>
<para>Next is a required message encoding binding element. You can use your own transport or use one of the following message encoding bindings: </para>
<list type="bullet">
<item>
<para>
<see cref="T:System.ServiceModel.Channels.TextMessageEncodingBindingElement" />
</para>
</item>
<item>
<para>
<see cref="T:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement" />
</para>
</item>
<item>
<para>
<see cref="T:System.ServiceModel.Channels.MtomMessageEncodingBindingElement" />
</para>
</item>
</list>
</item>
<item>
<para>At the bottom is a required transport element. You can use your own transport or use one of transport binding elements provided by indigo1: </para>
<list type="bullet">
<item>
<para>
<see cref="T:System.ServiceModel.Channels.TcpTransportBindingElement" />
</para>
</item>
<item>
<para>
<see cref="T:System.ServiceModel.Channels.NamedPipeTransportBindingElement" />
</para>
</item>
<item>
<para>
<see cref="T:System.ServiceModel.Channels.HttpTransportBindingElement" />
</para>
</item>
<item>
<para>
<see cref="T:System.ServiceModel.Channels.HttpsTransportBindingElement" />
</para>
</item>
<item>
<para>
<see cref="T:System.ServiceModel.Channels.MsmqTransportBindingElement" />
</para>
</item>
<item>
<para>
<see cref="T:System.ServiceModel.MsmqIntegration.MsmqIntegrationBindingElement" />
</para>
</item>
<item>
<para>
<see cref="T:System.ServiceModel.Channels.PeerTransportBindingElement" />
</para>
</item>
</list>
</item>
</list>
<para>The following table summarizes the options for each layer.</para>
<list type="table">
<listheader>
<item>
<term>
<para>Layer</para>
</term>
<description>
<para>Options</para>
</description>
<description>
<para>Required</para>
</description>
</item>
</listheader>
<item>
<term>
<para>Transaction Flow</para>
</term>
<description>
<para>
<see cref="T:System.ServiceModel.Channels.TransactionFlowBindingElement" />
</para>
</description>
<description>
<para>No</para>
</description>
</item>
<item>
<term>
<para>Reliability</para>
</term>
<description>
<para>
<see cref="T:System.ServiceModel.Channels.ReliableSessionBindingElement" />
</para>
</description>
<description>
<para>No</para>
</description>
</item>
<item>
<term>
<para>Security</para>
</term>
<description>
<para>Symmetric, Asymmetric, Transport-Level</para>
</description>
<description>
<para>No</para>
</description>
</item>
<item>
<term>
<para>Shape Change</para>
</term>
<description>
<para>
<see cref="T:System.ServiceModel.Channels.CompositeDuplexBindingElement" />
</para>
</description>
<description>
<para>No</para>
</description>
</item>
<item>
<term>
<para>Transport Upgrades</para>
</term>
<description>
<para>SSL stream, Windows stream, Peer Resolver</para>
</description>
<description>
<para>No</para>
</description>
</item>
<item>
<term>
<para>Encoding</para>
</term>
<description>
<para>Text, Binary, MTOM, Custom</para>
</description>
<description>
<para>Yes</para>
</description>
</item>
<item>
<term>
<para>Transport</para>
</term>
<description>
<para>TCP, Named Pipes, HTTP, HTTPS, flavors of MSMQ, Custom</para>
</description>
<description>
<para>Yes</para>
</description>
</item>
</list>
<para>In addition, you can define your own binding elements and insert them between any of the preceding defined layers.</para>
<para>For a discussion on how to use a custom binding to modify a system-provided binding, see <format type="text/html"><a href="f8b97862-e8bb-470d-8b96-07733c21fe26">How To: Customize a System-Provided Binding</a></format>.</para>
<block subset="none" type="note">
<para>When calling a indigo2 service built with.Net Framework 4.0 from a WCF client application built with netfx35_short or earlier, the configuration file generated by svcutil.exe or adding a service reference from vsprvs will contain the validity attribute in the binding configuration. This attribute is not recognized by the netfx35_short runtime and the application will thrown an <see cref="T:System.Configuration.ConfigurationErrorsException" /> with the message "Unrecognized attribute validity". To workaround this problem, remove the validity attribute from the binding configuration.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Defines a binding from a list of binding elements. </para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CustomBinding ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters />
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.ServiceModel.Channels.CustomBinding" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CustomBinding (System.Collections.Generic.IEnumerable<System.ServiceModel.Channels.BindingElement> bindingElements);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Collections.Generic.IEnumerable`1<class System.ServiceModel.Channels.BindingElement> bindingElements) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="bindingElements" Type="System.Collections.Generic.IEnumerable<System.ServiceModel.Channels.BindingElement>" />
</Parameters>
<Docs>
<param name="bindingElements">To be added.</param>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.ServiceModel.Channels.CustomBinding" /> class with the binding elements from a complete channel stack.</para>
</summary>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CustomBinding (System.ServiceModel.Channels.Binding binding);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.ServiceModel.Channels.Binding binding) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="binding" Type="System.ServiceModel.Channels.Binding" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.ServiceModel.Channels.CustomBinding" /> class from the values of a specified binding.</para>
</summary>
<param name="binding">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.Binding" /> that is used to initialize the custom binding.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CustomBinding (System.ServiceModel.Channels.BindingElement[] binding);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.ServiceModel.Channels.BindingElement[] binding) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="binding" Type="System.ServiceModel.Channels.BindingElement[]">
<Attributes>
<Attribute>
<AttributeName>System.ParamArray</AttributeName>
</Attribute>
</Attributes>
</Parameter>
</Parameters>
<Docs>
<param name="binding">To be added.</param>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.ServiceModel.Channels.CustomBinding" /> class from an array of binding elements.</para>
</summary>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CustomBinding (string name);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string name) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="name" Type="System.String" />
</Parameters>
<Docs>
<param name="name">To be added.</param>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The binding element named by </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.ServiceModel.Channels.CustomBinding" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CustomBinding (string name, string ns, System.ServiceModel.Channels.BindingElement[] binding);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string name, string ns, class System.ServiceModel.Channels.BindingElement[] binding) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="name" Type="System.String" />
<Parameter Name="ns" Type="System.String" />
<Parameter Name="binding" Type="System.ServiceModel.Channels.BindingElement[]">
<Attributes>
<Attribute>
<AttributeName>System.ParamArray</AttributeName>
</Attribute>
</Attributes>
</Parameter>
</Parameters>
<Docs>
<param name="binding">To be added.</param>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.ServiceModel.Channels.CustomBinding" /> class from an array of binding elements with a specified name and namespace.</para>
</summary>
<param name="name">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the binding.</param>
<param name="ns">
<attribution license="cc4" from="Microsoft" modified="false" />The namespace of the binding.</param>
</Docs>
</Member>
<Member MemberName="CreateBindingElements">
<MemberSignature Language="C#" Value="public override System.ServiceModel.Channels.BindingElementCollection CreateBindingElements ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance class System.ServiceModel.Channels.BindingElementCollection CreateBindingElements() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.ServiceModel.Channels.BindingElementCollection</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns a generic collection of the binding elements from the custom binding.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An <see cref="T:System.Collections.Generic.ICollection`1" /> object of type <see cref="T:System.ServiceModel.Channels.BindingElement" /> that contains the binding elements from the custom binding.</para>
</returns>
</Docs>
</Member>
<Member MemberName="Elements">
<MemberSignature Language="C#" Value="public System.ServiceModel.Channels.BindingElementCollection Elements { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.ServiceModel.Channels.BindingElementCollection Elements" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.ServiceModel.Channels.BindingElementCollection</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the binding elements from the custom binding.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Scheme">
<MemberSignature Language="C#" Value="public override string Scheme { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance string Scheme" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method is provided to enable binding validation against base addresses.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the URI scheme for transport used by the custom binding.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>
|
