File: FileIOPermissionAttribute.xml

package info (click to toggle)
monodoc 1.1.18-1
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 58,432 kB
  • ctags: 4,991
  • sloc: xml: 718,392; cs: 38,337; sh: 3,172; perl: 554; makefile: 303
file content (282 lines) | stat: -rwxr-xr-x 14,136 bytes parent folder | download
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
<Type Name="FileIOPermissionAttribute" FullName="System.Security.Permissions.FileIOPermissionAttribute" FullNameSP="System_Security_Permissions_FileIOPermissionAttribute" Maintainer="ecma">
  <TypeSignature Language="ILASM" Value=".class public sealed serializable FileIOPermissionAttribute extends System.Security.Permissions.CodeAccessSecurityAttribute" />
  <TypeSignature Language="C#" Value="public sealed class FileIOPermissionAttribute : System.Security.Permissions.CodeAccessSecurityAttribute" />
  <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>
  </AssemblyInfo>
  <ThreadingSafetyStatement>All public static members of this type are safe for multithreaded operations. No instance members are guaranteed to be thread safe.</ThreadingSafetyStatement>
  <Docs>
    <summary>
      <para> Used to declaratively specify security actions to control
      access to files and directories.</para>
    </summary>
    <remarks>
      <block subset="none" type="note">
        <para> The level of access to a file or directory is specified using the members of the
         current instance. For example, to specify read permissions for a file, set the
      <see cref="P:System.Security.Permissions.FileIOPermissionAttribute.Read" /> property
         equal to the name of the file.</para>
        <para> The security information declared by a
         security attribute is stored in the metadata of the attribute target, and is accessed by
         the system at run-time. Security attributes are used for
         declarative security only. For imperative security, use the corresponding
         permission class, <see cref="T:System.Security.Permissions.FileIOPermission" />.</para>
        <para>The allowable <see cref="T:System.Security.Permissions.FileIOPermissionAttribute" /> targets are
      determined by the <see cref="T:System.Security.Permissions.SecurityAction" /> passed to the constructor.</para>
      </block>
      <para>Case-sensitivity of file and directory names is
   platform dependent. The set of characters that are valid for use in file and
   directory names is determined by the current file system.</para>
    </remarks>
    <example>
      <para>The following example shows a declarative request for full access to the
      specified file. The <see cref="F:System.Security.Permissions.SecurityAction.RequestMinimum" /> security action
      indicates that this is the minimum permission required for the target assembly
      to be able to execute.</para>
      <para>
        <c>[assembly:FileIOPermissionAttribute(SecurityAction.RequestMinimum, All="\\example\\sample.txt")]
   </c>
      </para>
      <para>The following example shows how to demand that the
      calling code has unrestricted access to files and directories. Demands are
      typically made to protect methods or classes from malicious code. </para>
      <para>
        <c>[FileIOPermissionAttribute(SecurityAction.Demand, Unrestricted=true)]</c>
      </para>
    </example>
  </Docs>
  <Base>
    <BaseTypeName>System.Security.Permissions.CodeAccessSecurityAttribute</BaseTypeName>
  </Base>
  <Interfaces />
  <Attributes>
    <Attribute>
      <AttributeName>System.AttributeUsage(System.AttributeTargets.All, AllowMultiple=true, Inherited=false)</AttributeName>
    </Attribute>
  </Attributes>
  <Members>
    <Member MemberName="CreatePermission">
      <MemberSignature Language="ILASM" Value=".method public hidebysig virtual class System.Security.IPermission CreatePermission()" />
      <MemberSignature Language="C#" Value="public override IPermission CreatePermission();" />
      <MemberType>Method</MemberType>
      <ReturnValue>
        <ReturnType>System.Security.IPermission</ReturnType>
      </ReturnValue>
      <Parameters />
      <Docs>
        <summary>
          <para> Returns a new <see cref="T:System.Security.Permissions.FileIOPermission" /> that contains the security
   information of the current instance.</para>
        </summary>
        <returns>
          <para>A new <see cref="T:System.Security.Permissions.FileIOPermission" /> object with the security
   information of the current instance.</para>
        </returns>
        <remarks>
          <block subset="none" type="note">
            <para>Applications typically do not call this method; it is intended for use by the
         system.</para>
            <para>The security information declared by a security attribute is stored in the
         metadata of the attribute target, and is accessed by the system at run-time. The
         system uses the object returned by this method to convert the security
         information of the current instance into the form stored in metadata.</para>
            <para>This method overrides <see cref="M:System.Security.Permissions.SecurityAttribute.CreatePermission" />.</para>
          </block>
        </remarks>
      </Docs>
      <Excluded>0</Excluded>
    </Member>
    <Member MemberName=".ctor">
      <MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(valuetype System.Security.Permissions.SecurityAction action)" />
      <MemberSignature Language="C#" Value="public FileIOPermissionAttribute (System.Security.Permissions.SecurityAction action);" />
      <MemberType>Constructor</MemberType>
      <ReturnValue />
      <Parameters>
        <Parameter Name="action" Type="System.Security.Permissions.SecurityAction" />
      </Parameters>
      <Docs>
        <summary>
          <para>Constructs and initializes a new instance of the <see cref="T:System.Security.Permissions.FileIOPermissionAttribute" /> class
 with the specified <see cref="T:System.Security.Permissions.SecurityAction" /> value.</para>
        </summary>
        <param name="action">A <see cref="T:System.Security.Permissions.SecurityAction" /> value.</param>
        <exception cref="T:System.ArgumentException">
          <paramref name="action" /> is not a valid <see cref="T:System.Security.Permissions.SecurityAction" /> value. </exception>
        <remarks>To be added.</remarks>
      </Docs>
      <Excluded>0</Excluded>
    </Member>
    <Member MemberName="Read">
      <MemberSignature Language="ILASM" Value=".property string Read { public hidebysig specialname instance string get_Read() public hidebysig specialname instance void set_Read(string value) }" />
      <MemberSignature Language="C#" Value="public string Read { set; get; };" />
      <MemberType>Property</MemberType>
      <ReturnValue>
        <ReturnType>System.String</ReturnType>
      </ReturnValue>
      <Parameters />
      <Docs>
        <summary>
          <para> Gets or sets the name of a file or directory for which read access is
      secured.</para>
        </summary>
        <value>
          <para> A <see cref="T:System.String" /> containing
   the absolute path of the file or directory for which read access is secured.</para>
        </value>
        <exception cref="T:System.ArgumentException">The path information specified for a set operation contains invalid characters or wild card specifiers.</exception>
        <remarks>
          <para>
            <block subset="none" type="note">This property sets
      read access for a single file or directory; use additional
   <see cref="T:System.Security.Permissions.FileIOPermissionAttribute" />
   attributes to specify
   additional files and directories.</block>
          </para>
        </remarks>
      </Docs>
      <Excluded>0</Excluded>
    </Member>
    <Member MemberName="Write">
      <MemberSignature Language="ILASM" Value=".property string Write { public hidebysig specialname instance string get_Write() public hidebysig specialname instance void set_Write(string value) }" />
      <MemberSignature Language="C#" Value="public string Write { set; get; };" />
      <MemberType>Property</MemberType>
      <ReturnValue>
        <ReturnType>System.String</ReturnType>
      </ReturnValue>
      <Parameters />
      <Docs>
        <summary>
          <para> Gets or sets the name of a
      file or directory for which write access is secured.</para>
        </summary>
        <value>
          <para> A <see cref="T:System.String" /> containing
   the absolute path of the file or directory for which write access is secured.</para>
        </value>
        <exception cref="T:System.ArgumentException">The path information specified for a set operation contains invalid characters or wild card specifiers.</exception>
        <remarks>
          <para>
            <block subset="none" type="note">This property sets
      write access for a single file or directory; use additional <see cref="T:System.Security.Permissions.FileIOPermissionAttribute" />
      attributes to
      specify additional files and directories.</block>
          </para>
        </remarks>
      </Docs>
      <Excluded>0</Excluded>
    </Member>
    <Member MemberName="Append">
      <MemberSignature Language="ILASM" Value=".property string Append { public hidebysig specialname instance string get_Append() public hidebysig specialname instance void set_Append(string value) }" />
      <MemberSignature Language="C#" Value="public string Append { set; get; };" />
      <MemberType>Property</MemberType>
      <ReturnValue>
        <ReturnType>System.String</ReturnType>
      </ReturnValue>
      <Parameters />
      <Docs>
        <summary>
          <para> Gets or sets the name of a file or directory for which append access is secured.</para>
        </summary>
        <value>
          <para> A <see cref="T:System.String" /> containing
   the absolute path of the file or directory for which append access is secured.</para>
        </value>
        <exception cref="T:System.ArgumentException">The path information specified for a set operation contains invalid characters or wild card specifiers.</exception>
        <remarks>
          <para>
            <block subset="none" type="note">This property sets
      append access for a single file or directory; use additional
   <see cref="T:System.Security.Permissions.FileIOPermissionAttribute" />
   attributes to specify additional files
   and directories.</block>
          </para>
        </remarks>
      </Docs>
      <Excluded>0</Excluded>
    </Member>
    <Member MemberName="PathDiscovery">
      <MemberSignature Language="ILASM" Value=".property string PathDiscovery { public hidebysig specialname instance string get_PathDiscovery() public hidebysig specialname instance void set_PathDiscovery(string value) }" />
      <MemberSignature Language="C#" Value="public string PathDiscovery { set; get; };" />
      <MemberType>Property</MemberType>
      <ReturnValue>
        <ReturnType>System.String</ReturnType>
      </ReturnValue>
      <Parameters />
      <Docs>
        <summary>
          <para> Gets or sets the name of a file or directory for which path discovery
      access is secured.</para>
        </summary>
        <value>
          <para>A <see cref="T:System.String" /> containing
   the absolute path of the file or directory for which access to the
   contents of the path is secured.</para>
        </value>
        <exception cref="T:System.ArgumentException">The path information specified for a set operation contains invalid characters or wild card specifiers.</exception>
        <remarks>
          <block subset="none" type="note">
            <para> This property sets path discovery access for a single
         file or directory; use additional <see cref="T:System.Security.Permissions.FileIOPermissionAttribute" />
         attributes to specify additional files and
         directories.</para>
            <para>Path discovery controls access to the information in the path itself. This
         protects sensitive information in the path, such as user names, as well as
         information about the directory structure revealed in the path. This value does
         not secure access to files or folders represented by the path.</para>
          </block>
        </remarks>
      </Docs>
      <Excluded>0</Excluded>
    </Member>
    
    <Member MemberName="All">
      <MemberSignature Language="ILASM" Value=".property string All { public hidebysig specialname instance void set_All(string value) }" />
      <MemberSignature Language="C#" Value="public string All { set; }" />
      <MemberType>Property</MemberType>
      <ReturnValue>
        <ReturnType>System.Void</ReturnType>
      </ReturnValue>
      <Parameters>
		<Parameter Name="value" Type="System.String" />
	</Parameters>
      <Docs>
        <summary>
          <para> Sets the name of a file or directory for which full access is
      secured.</para>
        </summary>
        <value>
          <para> A <see cref="T:System.String" /> containing
   the absolute path of the file or directory for which full access is secured.</para>
        </value>
        <exception cref="T:System.ArgumentException">The path information specified for a set operation contains invalid characters or wild card specifiers.</exception>
        <remarks>
          <para>This property is write-only.</para>
          <para>
            <block subset="none" type="note">This property sets
      full access for a single file or directory; use additional
   <see cref="T:System.Security.Permissions.FileIOPermissionAttribute" />
   attributes to specify additional files
   and directories.</block>
          </para>
        </remarks>
      </Docs>
      <Excluded>0</Excluded>
    </Member>
   <Member MemberName="All">
      <MemberSignature Language="C#" Value="public string All { set; get; };" />
      <MemberType>Property</MemberType>
      <ReturnValue>
        <ReturnType>System.String</ReturnType>
      </ReturnValue>
      <Docs>
        <summary>To be added.</summary>
        <value>To be added.</value>
        <remarks>To be added.</remarks>
      </Docs>
    </Member>
  </Members>
  <TypeExcluded>0</TypeExcluded>
</Type>