Authorization.Message プロパティ

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

Authorization.Message プロパティ

認証チャレンジに応答して、サーバーに返されるメッセージを取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 Message As String

Visual Basic (使用法)

Dim instance As Authorization
Dim value As String

value = instance.Message

C#

public string Message { get;
 }

C++

public:
property String^ Message {
    String^ get ();
}

J#

/** @property */
public String get_Message ()

JScript

public function get Message
 () : String

プロパティ値
認証チャレンジに応答してサーバーに返されるメッセージ。

解説

Message プロパティは、保護されたリソースにアクセスするときに、クライアントがサーバーに返す承認文字列を格納します。メッセージの実際の内容は、クライアントとサーバーが使用している認証の種類によって定義されます。たとえば、基本 HTTP 認証は、Kerberos 認証とは異なるメッセージを使用します。

事前認証をサポートしている場合、Message プロパティは初期要求で送信されます。

使用例

Message プロパティを使用して、認証チャレンジへの応答でサーバーに返されるメッセージを取得するコード例を次に示します。詳細については、AuthenticationManager クラスのトピックを参照してください。

Visual Basic

' Create the encrypted string according to the Basic authentication
 format as
' follows:
' a)Concatenate the username and password separated by colon;
' b)Apply ASCII encoding to obtain a stream of bytes;
' c)Apply Base64 encoding to this array of bytes to obtain the encoded
 
' authorization.
Dim BasicEncrypt As String
 = MyCreds.UserName + ":" + MyCreds.Password

Dim BasicToken As String
 = "Basic " + Convert.ToBase64String(ASCII.GetBytes(BasicEncrypt))

' Create an Authorization object using the encoded authorization above.
Dim resourceAuthorization As New
 Authorization(BasicToken)

' Get the Message property, which contains the authorization string
 that the 
' client returns to the server when accessing protected resources.
Console.WriteLine(ControlChars.Lf + " Authorization Message:{0}",
 resourceAuthorization.Message)

' Get the Complete property, which is set to true when the authentication
 process 
' between the client and the server is finished.
Console.WriteLine(ControlChars.Lf + " Authorization Complete:{0}",
 resourceAuthorization.Complete)

Console.WriteLine(ControlChars.Lf + " Authorization ConnectionGroupId:{0}",
 resourceAuthorization.ConnectionGroupId)

C#

// Create the encrypted string according to the Basic authentication
 format as
// follows:
// a)Concatenate the username and password separated by colon;
// b)Apply ASCII encoding to obtain a stream of bytes;
// c)Apply Base64 encoding to this array of bytes to obtain the encoded
 
// authorization.
string BasicEncrypt = MyCreds.UserName + ":" + MyCreds.Password;

string BasicToken = "Basic " + Convert.ToBase64String(ASCII.GetBytes(BasicEncrypt));

// Create an Authorization object using the encoded authorization above.
Authorization resourceAuthorization = new Authorization(BasicToken);

// Get the Message property, which contains the authorization string
 that the 
// client returns to the server when accessing protected resources.
Console.WriteLine("\n Authorization Message:{0}",resourceAuthorization.Message);

// Get the Complete property, which is set to true when the authentication
 process 
// between the client and the server is finished.
Console.WriteLine("\n Authorization Complete:{0}",resourceAuthorization.Complete);

C++

// Create the encrypted string according to the Basic authentication
 format as
// follows:
// a)Concatenate username and password separated by colon;
// b)Apply ASCII encoding to obtain a stream of bytes;
// c)Apply Base64 Encoding to this array of bytes to obtain the encoded
// authorization.
String^ BasicEncrypt = String::Concat( MyCreds->UserName, ":", MyCreds->Password
 );
String^ BasicToken = String::Concat( "Basic ", Convert::ToBase64String(
 ASCII->GetBytes( BasicEncrypt ) ) );

// Create an Authorization object using the above encoded authorization.
Authorization^ resourceAuthorization = gcnew Authorization( BasicToken );

// Get the Message property which contains the authorization string
 that the
// client returns to the server when accessing protected resources
Console::WriteLine( "\n Authorization Message: {0}", resourceAuthorization->Message
 );

// Get the Complete property which is set to true when the authentication
 process
// between the client and the server is finished.
Console::WriteLine( "\n Authorization Complete: {0}", resourceAuthorization->Complete
 );

J#

// Create the encrypted string according to the Basic authentication
 
// format as follows:
// a)Concatenate the username and password separated by colon;
// b)Apply ascii encoding to obtain a stream of bytes;
// c)Apply Base64 encoding to this array of bytes to obtain the encoded
 
// authorization.
String basicEncrypt = myCreds.get_UserName() + ":" 
    + myCreds.get_Password();
String basicToken = "Basic " 
    + Convert.ToBase64String(ascii.GetBytes(basicEncrypt));

// Create an Authorization object using the encoded
// authorization above.
Authorization resourceAuthorization = new Authorization(basicToken);

// Get the Message property, which contains the authorization string
 
// that the client returns to the server when accessing protected 
// resources.
Console.WriteLine("\n Authorization Message:{0}", 
    resourceAuthorization.get_Message());

// Get the Complete property, which is set to true when the 
// authentication process between the client and the
// server is finished.
Console.WriteLine("\n Authorization Complete:{0}", 
    System.Convert.ToString(resourceAuthorization.get_Complete()));

プラットフォーム

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 名前空間
IAuthenticationModule