WebClientProtocol.Credentials プロパティ

定義

XML Web サービス クライアント認証のセキュリティ資格情報を取得または設定します。

public System.Net.ICredentials Credentials { get; set; }

プロパティ値

XML Web サービス クライアントの ICredentials

次の例は、 という名前 Mathの XML Web サービスを呼び出す ASP.NET Web フォームです。 関数内では EnterBtn_Click 、Web フォームは プロパティを使用して認証資格情報を Credentials 明示的に設定します。 ユーザー名、パスワード、ドメインは、 クラスのコンストラクター NetworkCredential に渡されます。

重要

この例には、ユーザー入力を受け付けるテキスト ボックスがあります。これにより、セキュリティが脆弱になる可能性があります。 既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは HTML 要素が含まれていないかどうかが検証されます。 詳細については、以下を参照してください。

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Net" %>

<html>
    <script language="C#" runat="server">
       void EnterBtn_Click(Object Src, EventArgs E) 
          {
            MyMath.Math math = new MyMath.Math();
            
            // Obtain password from a secure store.
            String SecurelyStoredPassword = String.Empty; 
 
            // Set the client-side credentials using the Credentials property.
            ICredentials credentials = new NetworkCredential("Joe",SecurelyStoredPassword,"mydomain");
            math.Credentials = credentials;
       
            int total = math.Add(Convert.ToInt32(Num1.Text), Convert.ToInt32(Num2.Text));
            Total.Text = "Total: " + total.ToString();
         }
 
    </script>
 
    <body>
       <form action="MathClient.aspx" runat=server>
           
          Enter the two numbers you want to add and then press the Total button.
          <p>
          Number 1: <asp:textbox id="Num1" runat=server/>  +
          Number 2: <asp:textbox id="Num2" runat=server/> =
          <asp:button text="Total" Onclick="EnterBtn_Click" runat=server/>
          <p>
          <asp:label id="Total"  runat=server/>
          
       </form>
    </body>
 </html>

注釈

プロパティをCredentials使用する場合、XML Web サービス クライアントは、 などの NetworkCredentialを実装するICredentialsクラスをインスタンス化し、認証メカニズムに固有のクライアント資格情報を設定する必要があります。 クラスを NetworkCredential 使用して、基本、ダイジェスト、NTLM、Kerberos 認証メカニズムを使用して認証資格情報を設定できます。

Credentials プロパティが CredentialCache.DefaultCredentials に設定されている場合、クライアントはサーバーとネゴシエートする際に、サーバーの構成に応じて Kerberos 認証、NTLM 認証、またはその両方を使用します。

適用対象

製品 バージョン
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

こちらもご覧ください