WebPartPersonalization.ToggleScope Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
public:
virtual void ToggleScope();public virtual void ToggleScope ();abstract member ToggleScope : unit -> unit
override this.ToggleScope : unit -> unitPublic Overridable Sub ToggleScope ()Eccezioni
L'utente corrente non dispone della funzionalità utente per accedere all'ambito del campo Shared quando si tenta di passare dall'ambito del campo User a quello del campo Shared.
-oppure-
L'istanza WebPartPersonalization non ha completato l'inizializzazione.
-oppure-
Il valore dell'istanza Page per il controllo WebPartManager associato è null.
-oppure-
Il valore della proprietà Request nell'istanza WebPartManager associata del controllo Page è null.
È stato effettuato un tentativo di passare a un ambito non definito nell'enumerazione PersonalizationScope. Dal punto di vista tecnico tale situazione non dovrebbe mai verificarsi.
Esempio
Il codice seguente illustra l'uso del ToggleScope metodo . Questo codice fa parte di un esempio di codice più grande trovato nella descrizione della WebPartPersonalization classe.
// Allows authorized user to change personalization scope.
protected void Toggle_Scope_Button_Click(object sender, EventArgs e)
{
if (_manager.Personalization.CanEnterSharedScope)
{
_manager.Personalization.ToggleScope();
}
}
' Allows authorized user to change personalization scope.
Protected Sub Toggle_Scope_Button_Click(ByVal sender As Object, ByVal e As EventArgs)
If _manager.Personalization.CanEnterSharedScope Then
_manager.Personalization.ToggleScope()
End If
End Sub 'Toggle_Scope_Button_Click
Commenti
Questo metodo attiva l'ambito di personalizzazione della pagina attualmente in esecuzione. Attivando l'ambito viene restituito un Transfer nuovo elemento alla pagina corrente in esecuzione.
Questo metodo non esegue alcuna operazione se viene chiamata durante l'esportazione o l'importazione di un controllo Web part.
Se si verifica una richiesta di ambito attiva per una pagina inviata tramite una POST richiesta, i valori della stringa di query verranno mantenuti durante il trasferimento. I parametri della stringa di query non vengono mantenuti se la pagina è stata inviata tramite una GET richiesta.
