Udostępnij za pośrednictwem

WebClientProtocol.Credentials Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.Services.Protocols
Zestaw:
System.Web.Services.dll

Pobiera lub ustawia poświadczenia zabezpieczeń dla uwierzytelniania klienta usługi sieci Web XML.

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

Wartość właściwości

ICredentials

Element ICredentials dla klienta usługi sieci Web XML.

Przykłady

Poniższy przykład to formularz sieci Web ASP.NET, który wywołuje usługę sieci Web XML o nazwie Math. EnterBtn_Click W ramach funkcji formularz sieci Web jawnie ustawia poświadczenia uwierzytelniania przy użyciu Credentials właściwości . Nazwa użytkownika, hasło i domena są przekazywane do konstruktora NetworkCredential dla klasy .

Ważne

Ten przykład zawiera pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web sprawdzają, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz

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

Uwagi

W przypadku korzystania z Credentials właściwości klient usługi sieci Web XML musi utworzyć wystąpienie klasy implementowej ICredentials, takiej jak NetworkCredential, a następnie ustawić poświadczenia klienta specyficzne dla mechanizmu uwierzytelniania. Klasa NetworkCredential może służyć do ustawiania poświadczeń uwierzytelniania przy użyciu podstawowych mechanizmów uwierzytelniania, skrótu, NTLM i Kerberos.

Credentials Gdy właściwość jest ustawiona na CredentialCache.DefaultCredentials wartość , klient negocjuje z serwerem uwierzytelnianie Kerberos i/lub NTLM w zależności od konfiguracji serwera.

Dotyczy

Zobacz też