WebPermissionAttribute クラス

.NET Framework クラス ライブラリ リファレンス

WebPermissionAttribute クラス

インターネット リソースへのアクセス許可を指定します。このクラスは継承できません。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<AttributeUsageAttribute(AttributeTargets.Assembly Or AttributeTargets.Class
 Or AttributeTargets.Struct Or AttributeTargets.Constructor
 Or AttributeTargets.Method, AllowMultiple:=True, Inherited:=False)> _
Public NotInheritable Class
 WebPermissionAttribute
    Inherits CodeAccessSecurityAttribute

Visual Basic (使用法)

Dim instance As WebPermissionAttribute

C#

[SerializableAttribute] 
[AttributeUsageAttribute(AttributeTargets.Assembly|AttributeTargets.Class|AttributeTargets.Struct|AttributeTargets.Constructor|AttributeTargets.Method,
 AllowMultiple=true, Inherited=false)] 
public sealed class WebPermissionAttribute
 : CodeAccessSecurityAttribute

C++

[SerializableAttribute] 
[AttributeUsageAttribute(AttributeTargets::Assembly|AttributeTargets::Class|AttributeTargets::Struct|AttributeTargets::Constructor|AttributeTargets::Method,
 AllowMultiple=true, Inherited=false)] 
public ref class WebPermissionAttribute sealed
 : public CodeAccessSecurityAttribute

J#

/** @attribute SerializableAttribute() */ 
/** @attribute AttributeUsageAttribute(AttributeTargets.Assembly|AttributeTargets.Class|AttributeTargets.Struct|AttributeTargets.Constructor|AttributeTargets.Method,
 AllowMultiple=true, Inherited=false) */ 
public final class WebPermissionAttribute extends
 CodeAccessSecurityAttribute

JScript

SerializableAttribute 
AttributeUsageAttribute(AttributeTargets.Assembly|AttributeTargets.Class|AttributeTargets.Struct|AttributeTargets.Constructor|AttributeTargets.Method,
 AllowMultiple=true, Inherited=false) 
public final class WebPermissionAttribute extends
 CodeAccessSecurityAttribute

解説

WebPermissionAttribute を使用すると、どの URI 文字列と正規表現文字列をクラスで使用できるかを宣言によって指定できます。

WebPermissionAttribute で指定されたセキュリティ情報は、WebPermissionAttribute が適用されるクラスである属性ターゲットのメタデータに格納されます。その後、システムは、実行時にこの情報にアクセスします。コンストラクタに渡される System.Security.Permissions.SecurityAction は、許容 WebPermissionAttribute ターゲットを判断します。システムは、CreatePermission メソッドで返される WebPermission を使用して、属性ターゲットのセキュリティ情報をメタデータに格納されるシリアル化できる形式に変換します。

メモ
WebPermissionAttribute は、宣言セキュリティ でだけ使用されます。強制セキュリティ に対しては、対応する WebPermission を使用します。

使用例

WebPermissionAttribute をメソッドに適用する方法を次の例に示します。

Visual Basic

' Deny access to a specific resource by setting the ConnectPattern property.
 
<WebPermission(SecurityAction.Deny, ConnectPattern := "http://www\.contoso\.com/.*")>
 Public Sub Connect()

' Create a Connection.     
Dim myWebRequest As HttpWebRequest = CType(WebRequest.Create("http://www.contoso.com"),
 HttpWebRequest)
Console.WriteLine("This line should never be printed")
   

C#

    // Deny access to a specific resource by setting the ConnectPattern
 property. 
   [WebPermission(SecurityAction.Deny, ConnectPattern=@"http://www\.contoso\.com/")]

public void Connect() 
     {
        // Create a Connection.  
        HttpWebRequest myWebRequest = (HttpWebRequest)WebRequest.Create("http://www.contoso.com");
        Console.WriteLine("This line should never be printed");
     }

C++

public:
   // Deny access to a specific resource by setting the ConnectPattern
 property.
   [method:WebPermission(SecurityAction::Deny,ConnectPattern="http://www.contoso.com/")]

   void Connect()
   {
      // Create a Connection.
      HttpWebRequest^ myWebRequest = (HttpWebRequest^)(WebRequest::Create( "http://www.contoso.com"
 ));
      Console::WriteLine( "This line should never be printed" );
   }

J#

// Deny access to a specific resource by setting the ConnectPattern
 property. 
/** @attribute WebPermission(SecurityAction.Deny, ConnectPattern =
   "http://www\\.contoso\\.com/")
 */
public void Connect()
{
    // Create a Connection.  
    HttpWebRequest myWebRequest = 
        (HttpWebRequest) WebRequest.Create("http://www.contoso.com");
    Console.WriteLine("This line should never be printed");
} //Connect

継承階層

System.Object
   System.Attribute
     System.Security.Permissions.SecurityAttribute
       System.Security.Permissions.CodeAccessSecurityAttribute
        System.Net.WebPermissionAttribute

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
WebPermissionAttribute メンバ
System.Net 名前空間