Sdílet prostřednictvím

WebClientProtocol.Credentials Vlastnost

Definice

Obor názvů:
System.Web.Services.Protocols
Sestavení:
System.Web.Services.dll

Získá nebo nastaví přihlašovací údaje zabezpečení pro ověřování klienta webové služby 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

Hodnota vlastnosti

ICredentials

Klient ICredentials webové služby XML.

Příklady

Následující příklad je webový formulář ASP.NET, který volá webovou službu XML s názvem Math. Webový formulář v rámci EnterBtn_Click funkce explicitně nastaví ověřovací přihlašovací údaje pomocí Credentials vlastnosti. Uživatelské jméno, heslo a doména se předávají do konstruktoru NetworkCredential pro třídu.

Důležité

Tento příklad obsahuje textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřují, že vstup uživatele neobsahuje skripty ani elementy HTML. Další informace viz.

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

Poznámky

Při použití Credentials vlastnosti musí klient webové služby XML vytvořit instanci třídy implementační ICredentials, například NetworkCredentiala pak nastavit přihlašovací údaje klienta specifické pro mechanismus ověřování. Třídu NetworkCredential lze použít k nastavení přihlašovacích údajů pro ověřování pomocí základních mechanismů ověřování, algoritmů digest, NTLM a Kerberos.

Credentials Pokud je vlastnost nastavena takCredentialCache.DefaultCredentials, aby klient vyjednával se serverem k ověřování Kerberos a/nebo NTLM v závislosti na konfiguraci serveru.

Platí pro

Viz také