WebClientProtocol.Credentials Proprietà

Definizione

Ottiene o imposta le credenziali di sicurezza per l'autenticazione del client di servizio Web XML.

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

Valore della proprietà

ICredentials per il client del servizio Web XML.

Esempio

L'esempio seguente è un web form ASP.NET, che chiama un servizio Web XML denominato Math. All'interno della EnterBtn_Click funzione, il Web Form imposta in modo esplicito le credenziali di autenticazione usando la Credentials proprietà . Il nome utente, la password e il dominio vengono passati al costruttore per la NetworkCredential classe .

Importante

L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per altre informazioni, vedere

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

Commenti

Quando si usa la Credentials proprietà , un client del servizio Web XML deve creare un'istanza di una classe che implementa ICredentials, ad esempio NetworkCredential, e quindi impostare le credenziali client specifiche per il meccanismo di autenticazione. La NetworkCredential classe può essere usata per impostare le credenziali di autenticazione usando i meccanismi di autenticazione di base, digest, NTLM e Kerberos.

Quando la proprietà Credentials è impostata su CredentialCache.DefaultCredentials, il client negozia con il server per eseguire l’autenticazione Kerberos e/o NTLM in base alla configurazione del server.

Si applica a

Prodotto Versioni
.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

Vedi anche