Authorization.ProtectionRealm プロパティ

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

Authorization.ProtectionRealm プロパティ

Message プロパティで認証できる URI (Uniform Resource Identifier) のプレフィックスを取得または設定します。

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

Visual Basic (宣言)

Public Property ProtectionRealm As
 String()

Visual Basic (使用法)

Dim instance As Authorization
Dim value As String()

value = instance.ProtectionRealm

instance.ProtectionRealm = value

C#

public string[] ProtectionRealm { get;
 set; }

C++

public:
property array<String^>^ ProtectionRealm {
    array<String^>^ get ();
    void set (array<String^>^ value);
}

J#

/** @property */
public String[] get_ProtectionRealm ()

/** @property */
public void set_ProtectionRealm (String[] value)

JScript

public function get ProtectionRealm
 () : String[]

public function set ProtectionRealm
 (value : String[])

プロパティ値
URI プリフィックスを格納する文字列の配列。

解説

ProtectionRealm プロパティは、認証のために Message プロパティで使用できる URI プレフィックスのリストを格納します。WebRequest とその派生クラスは、URI をこのリストと比較して、Authorization が特定の URI で有効かどうかを判断します。

使用例

Message プロパティで認証できる URI のプレフィックスを取得または設定するコード例を次に示します。

Visual Basic

Function Authenticate(ByVal challenge As
 String, ByVal request As
 WebRequest, ByVal credentials As ICredentials) As Authorization Implements IAuthenticationModule.Authenticate
    Try
        Dim message As String
        ' Check if Challenge string was raised by a site which requires
 'CloneBasic' authentication.
        If challenge Is Nothing
 Or Not challenge.StartsWith("CloneBasic")
 Then
            Return Nothing
        End If
        Dim myCredentials As NetworkCredential
        If TypeOf credentials Is
 CredentialCache Then
            myCredentials = credentials.GetCredential(request.RequestUri, "CloneBasic")
            If myCredentials Is Nothing
 Then
                Return Nothing
            End If
        Else
            myCredentials = CType(credentials, NetworkCredential)
        End If
        ' Message encryption scheme : 
        ' a)Concatenate username and password seperated by space
        ' b)Apply ASCII encoding to obtain a stream of bytes
        ' c)Apply Base64 Encoding to this array of bytes to obtain our
 encoded authorization message
        message = myCredentials.UserName + " " + myCredentials.Password
        ' Apply AsciiEncoding to 'message' string to obtain it as an
 array of bytes.
        Dim ascii As Encoding = Encoding.ASCII
        Dim byteArray(ascii.GetByteCount(message)) As
 Byte
        byteArray = ascii.GetBytes(message)

        ' Performing Base64 transformation.
        message = Convert.ToBase64String(byteArray)
        Dim myAuthorization As New
 Authorization("CloneBasic " + message, True)
        Dim protectionRealm() As String
 = {request.RequestUri.AbsolutePath}
        myAuthorization.ProtectionRealm = protectionRealm

        Return myAuthorization
    Catch e As Exception
        Console.WriteLine("The following exception was raised
 in Authenticate method:{0}", e.Message)
        Return Nothing
    End Try
End Function 'Authenticate

C#

public Authorization Authenticate( string challenge,WebRequest
 request,ICredentials credentials)
{
    try
    {
        string message;
        // Check if Challenge string was raised by a site which requires
 'CloneBasic' authentication.
        if ((challenge == null) || (!challenge.StartsWith("CloneBasic")))
            return null; 
        NetworkCredential myCredentials;
        if (credentials is CredentialCache)
        {
            myCredentials = credentials.GetCredential(request.RequestUri,"CloneBasic");
            if (myCredentials == null)
                return null;
        }
        else    
            myCredentials = (NetworkCredential)credentials;  
        // Message encryption scheme : 
        //   a)Concatenate username and password seperated by space;
        //   b)Apply ASCII encoding to obtain a stream of bytes;
        //   c)Apply Base64 Encoding to this array of bytes to obtain
 our encoded authorization message.
         
        message = myCredentials.UserName + " " + myCredentials.Password;
        // Apply AsciiEncoding to 'message' string to obtain it as an
 array of bytes.
        Encoding ascii = Encoding.ASCII;
        byte[] byteArray = new byte[ascii.GetByteCount(message)];
        byteArray = ascii.GetBytes(message);

        // Performing Base64 transformation.
        message = Convert.ToBase64String(byteArray);
        Authorization myAuthorization = new Authorization("CloneBasic
 " + message,true);
        string[] protectionRealm = new string[]{request.RequestUri.AbsolutePath};
        myAuthorization.ProtectionRealm = protectionRealm;

        return myAuthorization;
    }
    catch(Exception e)
    {
        Console.WriteLine("The following exception was raised in
 Authenticate method:{0}",e.Message);
        return null;
    }
  }

C++

virtual Authorization^ Authenticate( String^ challenge, WebRequest^ request, ICredentials^
 credentials )
{
   try
   {
      String^ message;

      // Check if Challenge String* was raised by a site which requires
 'CloneBasic' authentication.
      if ( (challenge == nullptr) || ( !challenge->StartsWith(
 "CloneBasic" )) )
               return nullptr;
      NetworkCredential^ myCredentials;
      if ( dynamic_cast<CredentialCache^>(credentials) ==
 nullptr )
      {
         myCredentials = credentials->GetCredential( request->RequestUri, "CloneBasic"
 );
         if ( myCredentials == nullptr )
                     return nullptr;
      }
      else
               myCredentials = dynamic_cast<NetworkCredential^>(credentials);

      // Message encryption scheme :
      //   a)Concatenate username and password seperated by space;
      //   b)Apply ASCII encoding to obtain a stream of bytes;
      //   c)Apply Base64 Encoding to this array of bytes to obtain
 our encoded authorization message.
      message = String::Concat( myCredentials->UserName, " ", myCredentials->Password
 );

      // Apply AsciiEncoding to 'message' String* to obtain it as an
 array of bytes.
      Encoding^ ascii = Encoding::ASCII;
      array<Byte>^byteArray = gcnew array<Byte>(ascii->GetByteCount(
 message ));
      byteArray = ascii->GetBytes( message );

      // Performing Base64 transformation.
      message = Convert::ToBase64String( byteArray );
      Authorization^ myAuthorization = gcnew Authorization( String::Concat( "CloneBasic
 ", message, true ) );
      array<String^>^protectionRealm = gcnew array<String^>(1);
      protectionRealm[ 0 ] = request->RequestUri->AbsolutePath;
      myAuthorization->ProtectionRealm = protectionRealm;
      return myAuthorization;
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "The following exception was raised in
 Authenticate method: {0}", e->Message );
      return nullptr;
   }
}

J#

public Authorization Authenticate(String challenge, WebRequest
 request, 
    ICredentials credentials)
{
    try {
        String message;

        // Check if Challenge string was raised by a site which requires
 
        // 'CloneBasic' authentication.
        if (challenge == null || !(challenge.StartsWith("CloneBasic")))
 {
            return null;
        }

        NetworkCredential myCredentials;
        if (credentials instanceof CredentialCache) {
            myCredentials = credentials.GetCredential(
                request.get_RequestUri(), "CloneBasic");
            if (myCredentials == null) {
                return null;
            }
        }
        else {
            myCredentials = (NetworkCredential)credentials;
        } 
        //   Message encryption scheme : 
        //   a)Concatenate userName and password seperated by space;
        //   b)Apply ASCII encoding to obtain a stream of bytes;
        //   c)Apply Base64 Encoding to this array of bytes to obtain
 our 
        //     encoded authorization message.
        message = myCredentials.get_UserName() + " " 
            + myCredentials.get_Password();

        // Apply AsciiEncoding to 'message' string to obtain it as an
 array
        // of bytes.
        Encoding ascii = Encoding.get_ASCII();
        ubyte byteArray[] = new ubyte[ascii.GetByteCount(message)];
        byteArray = ascii.GetBytes(message);

        // Performing Base64 transformation.
        message = Convert.ToBase64String(byteArray);
        Authorization myAuthorization = new Authorization("CloneBasic
 " 
            + message, true);
        String protectionRealm[] = new String[] 
            { request.get_RequestUri().get_AbsolutePath() };
        myAuthorization.set_ProtectionRealm(protectionRealm);
        return myAuthorization;
    }
    catch (System.Exception e) {
        Console.WriteLine("The following exception was raised in
 "
            + "Authenticate method:{0}", e.get_Message());
        return null;
    }
} //Authenticate

プラットフォーム

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
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Authorization クラス
Authorization メンバ
System.Net 名前空間