Share via

WebClientProtocol.Credentials Vlastnost

  • Reference

Definice

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

Získá nebo nastaví pověření 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

Pro ICredentials klienta 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 EnterBtn_Click rámci funkce explicitně nastaví přihlašovací údaje pro ověřování pomocí Credentials vlastnosti . Uživatelské jméno, heslo a doména jsou předány 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ěřte, že uživatelský vstup neobsahuje skript nebo elementy HTML. Další informace najdete v tématech:

<%@ 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 NetworkCredential, a poté 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 ověřovacích mechanismů, mechanismů hash, protokolů NTLM a Kerberos.

Credentials Když je vlastnost nastavená na CredentialCache.DefaultCredentials , klient vyjedná se serverem o ověřování protokolem Kerberos nebo NTLM v závislosti na tom, jak je server nakonfigurovaný.

Platí pro

Viz také