WebPartsPersonalization Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Umożliwia określenie dostawcy personalizacji i ustawienie autoryzacji personalizacji. Klasa ta nie może być dziedziczona.
public ref class WebPartsPersonalization sealed : System::Configuration::ConfigurationElement
public sealed class WebPartsPersonalization : System.Configuration.ConfigurationElement
type WebPartsPersonalization = class
inherit ConfigurationElement
Public NotInheritable Class WebPartsPersonalization
Inherits ConfigurationElement
- Dziedziczenie
Przykłady
W tym przykładzie pokazano, jak deklaratywnie określić wartości dla kilku atrybutów webParts sekcji, do których można również uzyskać dostęp jako elementy członkowskie WebPartsPersonalization klasy.
W poniższym przykładzie pliku konfiguracji pokazano, jak deklaratywnie określić wartości dla webParts sekcji.
<system.web>
<webParts>
<personalization
defaultProvider="AspNetSqlPersonalizationProvider">
<!-- Providers may only be defined at the
application level -->
<providers>
<add name="AspNetSqlPersonalizationProvider"
type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider"
connectionStringName="LocalSqlServer"
applicationName="/" />
</providers>
<authorization>
<deny users="*" verbs="enterSharedScope" />
<allow users="*" verbs="modifyState" />
</authorization>
</personalization>
</webParts>
</system.web>
W poniższym przykładzie kodu pokazano, jak używać WebPartsPersonalization klasy .
Ten przykład kodu jest częścią większego przykładu udostępnionego dla klasy WebPartsSection.
// Get the current DefaultProvider property value.
Console.WriteLine(
"Current DefaultProvider value: '{0}'",
webPartsSection.Personalization.DefaultProvider);
// Set the DefaultProvider property.
webPartsSection.Personalization.DefaultProvider =
"ASPNetSQLPersonalizationProvider";
// Add a provider.
webPartsSection.Personalization.Providers.Add(
new ProviderSettings("CustomProvider",
"MyCustomProviders.Provider"));
// List current providers.
for (int pi = 0;
pi < webPartsSection.Personalization.Providers.Count; pi++)
{
Console.WriteLine(" #{0} Name={1} Type={2}", pi,
webPartsSection.Personalization.Providers[pi].Name,
webPartsSection.Personalization.Providers[pi].Type);
}
// Add an authorization.
AuthorizationRule ar =
new AuthorizationRule(AuthorizationRuleAction.Allow);
ar.Verbs.Add("ModifyState");
ar.Users.Add("Admin");
webPartsSection.Personalization.Authorization.Rules.Add(ar);
// List current authorizations.
for (int ai = 0;
ai < webPartsSection.Personalization.Authorization.Rules.Count;
ai++)
{
Console.WriteLine(" #{0}:", ai);
AuthorizationRule aRule =
webPartsSection.Personalization.Authorization.Rules[ai];
Console.WriteLine(" Verbs=");
foreach (string verb in aRule.Verbs)
Console.WriteLine(" * {0}", verb);
Console.WriteLine(" Roles=");
foreach (string role in aRule.Roles)
Console.WriteLine(" * {0}", role);
Console.WriteLine(" Users=");
foreach (string user in aRule.Users)
Console.WriteLine(" * {0}", user);
}
' Get the current DefaultProvider property value.
Console.WriteLine( _
"Current DefaultProvider value: '{0}'", _
webPartsSection.Personalization.DefaultProvider)
' Set the DefaultProvider property.
webPartsSection.Personalization.DefaultProvider = _
"ASPNetSQLPersonalizationProvider"
' Add a provider.
webPartsSection.Personalization.Providers.Add( _
New ProviderSettings("CustomProvider", _
"MyCustomProviders.Provider"))
' List current providers.
Dim pi As Integer
For pi = 0 To webPartsSection.Personalization.Providers.Count - 1
Console.WriteLine(" #{0} Name={1} Type={2}", pi, _
webPartsSection.Personalization.Providers(pi).Name, _
webPartsSection.Personalization.Providers(pi).Type)
Next
' Add an authorization.
Dim ar As AuthorizationRule = _
New AuthorizationRule(AuthorizationRuleAction.Allow)
ar.Verbs.Add("ModifyState")
ar.Users.Add("Admin")
webPartsSection.Personalization.Authorization.Rules.Add(ar)
' List current authorizations.
Dim ai As Integer
For ai = 0 To _
webPartsSection.Personalization.Authorization.Rules.Count
Console.WriteLine(" #{0}:", ai)
Dim aRule As AuthorizationRule = _
webPartsSection.Personalization.Authorization.Rules(ai)
Console.WriteLine(" Verbs=")
Dim verb As String
For Each verb In aRule.Verbs
Console.WriteLine(" * {0}", verb)
Console.WriteLine(" Roles=")
Next
Dim role As String
For Each role In aRule.Roles
Console.WriteLine(" * {0}", role)
Console.WriteLine(" Users=")
Next
Dim user As String
For Each user In aRule.Users
Console.WriteLine(" * {0}", user)
Next
Next
Uwagi
WebPartsPersonalization Zapewnia obsługę konfiguracji opcji personalizacji składników Web Part, takich jak dostawca personalizacji i autoryzacje personalizacji.
Konstruktory
| Nazwa | Opis |
|---|---|
| WebPartsPersonalization() |
Inicjuje WebPartsPersonalization nowe wystąpienie klasy przy użyciu ustawień domyślnych. |
Właściwości
| Nazwa | Opis |
|---|---|
| Authorization |
AuthorizationSection Pobiera obiekt zawierający autoryzacje personalizacji składników Web Part dla bieżącej aplikacji sieci Web. |
| CurrentConfiguration |
Pobiera odwołanie do wystąpienia najwyższego poziomu Configuration, które reprezentuje hierarchię konfiguracji, do którego należy bieżące wystąpienie ConfigurationElement. (Odziedziczone po ConfigurationElement) |
| DefaultProvider |
Pobiera lub ustawia nazwę domyślnego dostawcy personalizacji składników Web Part. |
| ElementInformation |
Pobiera obiekt ElementInformation zawierający informacje i funkcje obiektu ConfigurationElement, które nie można dostosowywać. (Odziedziczone po ConfigurationElement) |
| ElementProperty |
Pobiera obiekt ConfigurationElementProperty reprezentujący sam obiekt ConfigurationElement. (Odziedziczone po ConfigurationElement) |
| EvaluationContext |
Pobiera obiekt ContextInformation dla obiektu ConfigurationElement. (Odziedziczone po ConfigurationElement) |
| HasContext |
Pobiera wartość wskazującą, czy właściwość CurrentConfiguration jest |
| Item[ConfigurationProperty] |
Pobiera lub ustawia właściwość lub atrybut tego elementu konfiguracji. (Odziedziczone po ConfigurationElement) |
| Item[String] |
Pobiera lub ustawia właściwość, atrybut lub element podrzędny tego elementu konfiguracji. (Odziedziczone po ConfigurationElement) |
| LockAllAttributesExcept |
Pobiera kolekcję zablokowanych atrybutów. (Odziedziczone po ConfigurationElement) |
| LockAllElementsExcept |
Pobiera kolekcję zablokowanych elementów. (Odziedziczone po ConfigurationElement) |
| LockAttributes |
Pobiera kolekcję zablokowanych atrybutów. (Odziedziczone po ConfigurationElement) |
| LockElements |
Pobiera kolekcję zablokowanych elementów. (Odziedziczone po ConfigurationElement) |
| LockItem |
Pobiera lub ustawia wartość wskazującą, czy element jest zablokowany. (Odziedziczone po ConfigurationElement) |
| Properties |
Pobiera kolekcję właściwości. (Odziedziczone po ConfigurationElement) |
| Providers |
Pobiera kolekcję zawierającą ProviderSettingsCollection dostawców personalizacji składników Web Part dla bieżącej aplikacji internetowej. |
Metody
| Nazwa | Opis |
|---|---|
| DeserializeElement(XmlReader, Boolean) |
Odczytuje kod XML z pliku konfiguracji. (Odziedziczone po ConfigurationElement) |
| Equals(Object) |
Porównuje bieżące wystąpienie ConfigurationElement z określonym obiektem. (Odziedziczone po ConfigurationElement) |
| GetHashCode() |
Pobiera unikatową wartość reprezentującą bieżące wystąpienie ConfigurationElement. (Odziedziczone po ConfigurationElement) |
| GetTransformedAssemblyString(String) |
Zwraca przekształconą wersję określonej nazwy zestawu. (Odziedziczone po ConfigurationElement) |
| GetTransformedTypeString(String) |
Zwraca przekształconą wersję określonej nazwy typu. (Odziedziczone po ConfigurationElement) |
| GetType() |
Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object) |
| Init() |
Ustawia obiekt ConfigurationElement na stan początkowy. (Odziedziczone po ConfigurationElement) |
| InitializeDefault() |
Służy do inicjowania domyślnego zestawu wartości dla obiektu ConfigurationElement. (Odziedziczone po ConfigurationElement) |
| IsModified() |
Wskazuje, czy ten element konfiguracji został zmodyfikowany od czasu ostatniego zapisania lub załadowania, gdy został zaimplementowany w klasie pochodnej. (Odziedziczone po ConfigurationElement) |
| IsReadOnly() |
Pobiera wartość wskazującą, czy obiekt ConfigurationElement jest tylko do odczytu. (Odziedziczone po ConfigurationElement) |
| ListErrors(IList) |
Dodaje błędy nieprawidłowej właściwości w tym obiekcie ConfigurationElement i we wszystkich elementach podrzędnych do przekazanej listy. (Odziedziczone po ConfigurationElement) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object) |
| OnDeserializeUnrecognizedAttribute(String, String) |
Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany atrybut. (Odziedziczone po ConfigurationElement) |
| OnDeserializeUnrecognizedElement(String, XmlReader) |
Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany element. (Odziedziczone po ConfigurationElement) |
| OnRequiredPropertyNotFound(String) |
Zgłasza wyjątek, gdy nie można odnaleźć wymaganej właściwości. (Odziedziczone po ConfigurationElement) |
| PostDeserialize() |
Wywoływana po deserializacji. (Odziedziczone po ConfigurationElement) |
| PreSerialize(XmlWriter) |
Wywoływana przed serializacji. (Odziedziczone po ConfigurationElement) |
| Reset(ConfigurationElement) |
Resetuje stan wewnętrzny obiektu ConfigurationElement, w tym blokady i kolekcje właściwości. (Odziedziczone po ConfigurationElement) |
| ResetModified() |
Resetuje wartość metody IsModified(), aby |
| SerializeElement(XmlWriter, Boolean) |
Zapisuje zawartość tego elementu konfiguracji w pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Odziedziczone po ConfigurationElement) |
| SerializeToXmlElement(XmlWriter, String) |
Zapisuje zewnętrzne tagi tego elementu konfiguracji do pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Odziedziczone po ConfigurationElement) |
| SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Ustawia właściwość na określoną wartość. (Odziedziczone po ConfigurationElement) |
| SetReadOnly() |
Ustawia właściwość IsReadOnly() dla obiektu ConfigurationElement i wszystkich podelementów. (Odziedziczone po ConfigurationElement) |
| ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
| Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Modyfikuje obiekt ConfigurationElement, aby usunąć wszystkie wartości, które nie powinny być zapisywane. (Odziedziczone po ConfigurationElement) |