File: IAsyncResult.xml

package info (click to toggle)
monodoc 1.9-2
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 98,436 kB
  • ctags: 5,261
  • sloc: xml: 1,506,218; cs: 40,827; sh: 3,647; perl: 554; makefile: 476
file content (216 lines) | stat: -rwxr-xr-x 9,319 bytes parent folder | download | duplicates (3)
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
<Type Name="IAsyncResult" FullName="System.IAsyncResult" FullNameSP="System_IAsyncResult" Maintainer="ecma">
  <TypeSignature Language="ILASM" Value=".class interface public abstract IAsyncResult" />
  <TypeSignature Language="C#" Value="public interface IAsyncResult" />
  <MemberOfLibrary>BCL</MemberOfLibrary>
  <AssemblyInfo>
    <AssemblyName>mscorlib</AssemblyName>
    <AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00 ]</AssemblyPublicKey>
    <AssemblyVersion>1.0.5000.0</AssemblyVersion>
    <AssemblyVersion>2.0.0.0</AssemblyVersion>
  </AssemblyInfo>
  <Docs>
    <summary>
      <para> Supported by objects
      that represent the state
      of an asynchronous operation.
      </para>
    </summary>
    <remarks>
      <para>An object that supports the <see cref="T:System.IAsyncResult" />
interface stores state information for an asynchronous operation, and provides a
synchronization object to allow threads to be signaled when the operation
completes.</para>
      <para>
        <see cref="T:System.IAsyncResult" /> objects are returned by methods that begin
asynchronous operations, such as <see cref="M:System.IO.FileStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)" />, and are passed to methods used to
complete asynchronous operations, such as <see cref="M:System.IO.FileStream.EndRead(System.IAsyncResult)" />. <see cref="T:System.IAsyncResult" />
objects are also passed to methods invoked by <see cref="T:System.AsyncCallback" /> delegates
when an asynchronous operation completes.</para>
    </remarks>
  </Docs>
  <Members>
    <Member MemberName="AsyncState">
      <MemberSignature Language="ILASM" Value=".property object AsyncState { public hidebysig virtual abstract specialname object get_AsyncState() }" />
      <MemberSignature Language="C#" Value="public object AsyncState { get; }" />
      <MemberType>Property</MemberType>
      <ReturnValue>
        <ReturnType>System.Object</ReturnType>
      </ReturnValue>
      <Parameters />
      <Docs>
        <summary>
          <para> Gets the user-provided state object supplied at the time the asynchronous
      operation was started.
      </para>
        </summary>
        <value>
          <para>The supplied <see cref="T:System.Object" />.</para>
        </value>
        <remarks>
          <block subset="none" type="behaviors">
            <para> The object returned by this property is required to be
         the object specified as the last parameter to methods that begin asynchronous
         operations, such as <see cref="M:System.IO.FileStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)" />.</para>
            <para>This property is read-only.</para>
          </block>
          <para>
            <block subset="none" type="overrides">
      
      Implement this property to allow the caller of an
      asynchronous operation to obtain an application-defined object specified at the
      start of the operation.
      </block>
          </para>
          <para>
            <block subset="none" type="usage"> The object returned by
      
      this property can be used to pass state information for
      the asynchronous operation to a <see cref="T:System.AsyncCallback" />
      delegate.
      </block>
          </para>
        </remarks>
      </Docs>
      <Excluded>0</Excluded>
      <AssemblyInfo>
        <AssemblyVersion>1.0.5000.0</AssemblyVersion>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="AsyncWaitHandle">
      <MemberSignature Language="ILASM" Value=".property class System.Threading.WaitHandle AsyncWaitHandle { public hidebysig virtual abstract specialname class System.Threading.WaitHandle get_AsyncWaitHandle() }" />
      <MemberSignature Language="C#" Value="public System.Threading.WaitHandle AsyncWaitHandle { get; }" />
      <MemberType>Property</MemberType>
      <ReturnValue>
        <ReturnType>System.Threading.WaitHandle</ReturnType>
      </ReturnValue>
      <Parameters />
      <Docs>
        <summary>
          <para> Gets a <see cref="T:System.Threading.WaitHandle" /> that can be used to block a thread until an asynchronous
   operation completes.</para>
        </summary>
        <value>
          <para>A <see cref="T:System.Threading.WaitHandle" /> that is signaled when an asynchronous operation completes.</para>
        </value>
        <remarks>
          <block subset="none" type="behaviors">
            <para>The object returned by <see cref="P:System.IAsyncResult.AsyncWaitHandle" /> can be allocated in advance or on demand. However, once
      allocated it is required to be kept alive until the user calls a method that
      ends the asynchronous operation, such as <see cref="M:System.IO.FileStream.EndRead(System.IAsyncResult)" />.
      Only after the operation completes or is canceled, can the object be disposed
      of.</para>
            <para>
              <block subset="none" type="note">
                <see langword="WaitHandle" /> supplies methods that support waiting 
   for synchronization objects to become signaled, such as <see cref="M:System.Threading.WaitHandle.WaitOne(System.Int32,System.Boolean)" />
   .</block>
            </para>
            <para>This property is read-only.</para>
          </block>
          <block subset="none" type="usage">
            <para>Clients that wait for the operation to complete (as
      opposed to polling), use this property to obtain a synchronization object to
      wait on.</para>
          </block>
        </remarks>
      </Docs>
      <Excluded>0</Excluded>
      <AssemblyInfo>
        <AssemblyVersion>1.0.5000.0</AssemblyVersion>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="CompletedSynchronously">
      <MemberSignature Language="ILASM" Value=".property bool CompletedSynchronously { public hidebysig virtual abstract specialname bool get_CompletedSynchronously() }" />
      <MemberSignature Language="C#" Value="public bool CompletedSynchronously { get; }" />
      <MemberType>Property</MemberType>
      <ReturnValue>
        <ReturnType>System.Boolean</ReturnType>
      </ReturnValue>
      <Parameters />
      <Docs>
        <summary>
          <para> Gets a <see cref="T:System.Boolean" /> 
value that specifies whether the
asynchronous operation completed synchronously.</para>
        </summary>
        <value>
          <para>
            <see langword="true" /> if the operation synchronously;
   otherwise <see langword="false" />. </para>
        </value>
        <remarks>
          <block subset="none" type="behaviors">
            <para> 
         As described above.</para>
            <para>
              <block subset="none" type="note">Most 
         implementations of the <see cref="T:System.IAsyncResult" /> interface will not use this property, and should return
      <see langword="false" /> 
      .</block>
            </para>
            <para>This property is read-only.</para>
          </block>
          <para>
            <block subset="none" type="usage">
   Use this property to determine if the asynchronous
   operation completed synchronously. For example, this property can return
<see langword="true" /> for an asynchronous IO
   operation if the IO request was small.
</block>
          </para>
        </remarks>
      </Docs>
      <Excluded>0</Excluded>
      <AssemblyInfo>
        <AssemblyVersion>1.0.5000.0</AssemblyVersion>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="IsCompleted">
      <MemberSignature Language="ILASM" Value=".property bool IsCompleted { public hidebysig virtual abstract specialname bool get_IsCompleted() }" />
      <MemberSignature Language="C#" Value="public bool IsCompleted { get; }" />
      <MemberType>Property</MemberType>
      <ReturnValue>
        <ReturnType>System.Boolean</ReturnType>
      </ReturnValue>
      <Parameters />
      <Docs>
        <summary>
          <para> Gets a <see cref="T:System.Boolean" /> 
value that specifies
whether an asynchronous operation has completed.</para>
        </summary>
        <value>
          <para>
            <see langword="true" /> if the operation has completed;
   otherwise <see langword="false" />.</para>
        </value>
        <remarks>
          <block subset="none" type="behaviors">
            <para>As described above. </para>
            <para>This property is read-only.</para>
          </block>
          <block subset="none" type="usage">
            <para>Clients that poll for operation status (as opposed to waiting on a
         synchronization object) use this property to determine the status of the
         operation.</para>
          </block>
        </remarks>
      </Docs>
      <Excluded>0</Excluded>
      <AssemblyInfo>
        <AssemblyVersion>1.0.5000.0</AssemblyVersion>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
  </Members>
  <TypeExcluded>0</TypeExcluded>
  <Interfaces />
  <Attributes>
    <Attribute>
      <AttributeName>System.Runtime.InteropServices.ComVisible(true)</AttributeName>
    </Attribute>
  </Attributes>
</Type>