Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo PersonalizationAdministration.FindUserState (String, String)

 

Data di pubblicazione: ottobre 2016

Restituisce una raccolta di informazioni sullo stato di personalizzazione per singolo utente in base al percorso di pagina e nome utente.

Spazio dei nomi:   System.Web.UI.WebControls.WebParts
Assembly:  System.Web (in System.Web.dll)

public static PersonalizationStateInfoCollection FindUserState(
	string pathToMatch,
	string usernameToMatch
)

Parametri

pathToMatch
Type: System.String

Il percorso della pagina per trovare la corrispondenza.

usernameToMatch
Type: System.String

Il nome utente per la corrispondenza con i dati di personalizzazione associati alla pagina.

Valore restituito

Type: System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection

Oggetto PersonalizationStateInfoCollection che contiene informazioni sullo stato di personalizzazione per singolo utente.

Exception Condition
ArgumentException

pathToMatch o usernameToMatch prima o dopo la rimozione è una stringa vuota ("").

-oppure-

Il provider per un provider di personalizzazione definito nella configurazione non è del tipo corretto.

-oppure-

La lunghezza della stringa di qualsiasi parametro è maggiore di 256 caratteri.

ConfigurationErrorsException

Si è verificata un'eccezione di configurazione durante il tentativo di creare e inizializzare un'istanza di uno dei provider di personalizzazioni.

-oppure-

Impossibile trovare il provider di personalizzazione predefinito definito nella configurazione.

Questo metodo restituisce una raccolta di UserPersonalizationStateInfo istanze in cui il pathToMatch valore del parametro corrisponda al percorso di una pagina e usernameToMatch corrisponde a un nome utente che dispone di dati di personalizzazione associati a tale pagina. La raccolta contiene solo UserPersonalizationStateInfo istanze.

Questo metodo passa caratteri jolly di parametro al provider di personalizzazioni sottostante, così come l'archivio dati gestisce questi caratteri dipende da come il provider gestisce i caratteri, ad esempio un asterisco (*), un simbolo di percentuale (%) o un carattere di sottolineatura (_).

In genere, per gli archivi dati compatibili con SQL, è possibile eseguire una ricerca con caratteri jolly in un percorso parziale con il carattere jolly appare all'inizio, fine o al centro del testo della stringa di ricerca nel PathToMatch proprietà. Ad esempio, per trovare tutti i percorsi che iniziano con "~/vdir", il PathToMatch sarebbe impostata su "~/vdir%".

Allo stesso modo, una ricerca con caratteri jolly in un nome utente parziale può visualizzare il carattere jolly in qualsiasi punto nella stringa di testo della UsernameToMatch proprietà. Ad esempio, per trovare tutti i nomi utente che iniziano con "John", il UsernameToMatch proprietà sarà simile a "John %".

Utilizzando il provider di personalizzazione predefinito, il PersonalizationStateInfo-oggetti derivati vengono restituiti in ordine alfabetico e ordinati in base a una combinazione di percorso e il nome utente in ordine crescente. L'ordine degli oggetti nella raccolta è determinato dal provider.

Entrambi pathToMatch e usernameToMatch può essere null. Il usernameToMatch parametro può includere virgole (,) poiché alcuni archivi dati, quali quelli che eseguono Microsoft SQL Server, l'utilizzo di virgole come caratteri jolly.

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo FindUserState. L'esempio completo è reperibile nella PersonalizationAdministration Cenni preliminari sulla classe.

System_CAPS_security Sicurezza Nota

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 Script Exploits Overview.

protected void Button1_Click(object sender, EventArgs e)
{
    if (TextBox3.Text != null)
    {
        PersonalizationStateInfoCollection findresult;
      findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
      if (findresult.Count != 0)
      {
          Label4.Text = findresult.Count + "  user(s) found";
          Label4.Visible = true;
      }
      else
      {
          Label4.Text = "No users found.";
          Label4.Visible = true;
      }
    }
  else
  {
      Label4.Text = "You must enter a user name to find.";
  }

}

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: