Aracılığıyla paylaş

WebClientProtocol.Credentials Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.Services.Protocols
Bütünleştirilmiş Kod:
System.Web.Services.dll

XML Web hizmeti istemci kimlik doğrulaması için güvenlik kimlik bilgilerini alır veya ayarlar.

public:
 property System::Net::ICredentials ^ Credentials { System::Net::ICredentials ^ get(); void set(System::Net::ICredentials ^ value); };
public System.Net.ICredentials Credentials { get; set; }
member this.Credentials : System.Net.ICredentials with get, set
Public Property Credentials As ICredentials

Özellik Değeri

ICredentials

ICredentials XML Web hizmeti istemcisi için.

Örnekler

Aşağıdaki örnek, adlı Mathbir XML Web hizmetini çağıran bir ASP.NET Web Formudur. işlevinde EnterBtn_Click , Web Formu özelliğini kullanarak Credentials kimlik doğrulama kimlik bilgilerini açıkça ayarlar. Kullanıcı adı, parola ve etki alanı, sınıfın oluşturucusuna NetworkCredential geçirilir.

Önemli

Bu örnekte, olası bir güvenlik tehdidi olan kullanıcı girişini kabul eden bir metin kutusu vardır. Varsayılan olarak, ASP.NET Web sayfaları kullanıcı girişinin betik veya HTML öğeleri içermediğini doğrular. Daha fazla bilgi için, bkz.

<%@ 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>

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

<html>
    <script language="VB" runat="server">
        Sub EnterBtn_Click(src As Object, e As EventArgs)
            Dim math As New MyMath.Math()

            ' Obtain password from a secure store.
            Dim SecurelyStoredPassword As String = String.Empty
            
            ' Set the client-side credentials using the Credentials property.
            Dim credentials = New NetworkCredential("Joe", SecurelyStoredPassword, "mydomain")
            math.Credentials = credentials
            
            Dim iTotal As Integer = math.Add(Convert.ToInt32(Num1.Text), Convert.ToInt32(Num2.Text))
            Total.Text = "Total: " + iTotal.ToString()
        End Sub
 
    </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>

Açıklamalar

özelliği kullanılırkenCredentials, XML Web hizmeti istemcisinin gibi NetworkCredentialuygulayan ICredentialsbir sınıf örneği oluşturması ve ardından istemci kimlik bilgilerini kimlik doğrulama mekanizmasına özgü olarak ayarlaması gerekir. sınıfı NetworkCredential temel, özet, NTLM ve Kerberos kimlik doğrulama mekanizmalarını kullanarak kimlik doğrulama kimlik bilgilerini ayarlamak için kullanılabilir.

Credentials Özelliği olarak CredentialCache.DefaultCredentials ayarlandığında istemci, sunucunun nasıl yapılandırıldığına bağlı olarak Kerberos ve/veya NTLM kimlik doğrulaması yapmak için sunucuyla anlaşma yapar.

Şunlara uygulanır

Ayrıca bkz.