WebPartManager.ExportWebPart(WebPart, XmlWriter) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls.WebParts

Zestaw:: System.Web.dll

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.

Tworzy plik opisu XML zawierający dane stanu i właściwości dla kontrolki serwera.

public:
 virtual void ExportWebPart(System::Web::UI::WebControls::WebParts::WebPart ^ webPart, System::Xml::XmlWriter ^ writer);

public virtual void ExportWebPart (System.Web.UI.WebControls.WebParts.WebPart webPart, System.Xml.XmlWriter writer);

abstract member ExportWebPart : System.Web.UI.WebControls.WebParts.WebPart * System.Xml.XmlWriter -> unit
override this.ExportWebPart : System.Web.UI.WebControls.WebParts.WebPart * System.Xml.XmlWriter -> unit

Public Overridable Sub ExportWebPart (webPart As WebPart, writer As XmlWriter)

Parametry

webPart: WebPart

Kontrolka, z której zostaną wyeksportowane dane.

writer: XmlWriter

Element XmlWriter , który zapisuje wyeksportowane dane z webPart pliku opisu XML.

Wyjątki

ArgumentNullException

webPart to null.

-lub-

writer to null.

ArgumentException

webPart nie jest zawarta w kolekcji kontrolek, do których odwołuje się element Controls.

-lub-

Właściwość ExportMode jest webPart ustawiona na wartość , Noneco oznacza, że eksport jest wyłączony dla webPartelementu .

Uwagi

Metoda ExportWebPart składa różne dane stanu i właściwości z webPart pliku XML. Dane zawierają informacje dotyczące samej kontrolki, w tym jej zestaw, dane stanu i dane właściwości. Użytkownik, który inicjuje eksport, może zapisać plik XML na dysku na komputerze lokalnym lub w sieci. Inni użytkownicy mogą następnie zaimportować plik opisu do innej strony lub witryny sieci Web i zastosować dane stanu i właściwości do innego wystąpienia programu webPart. Zapewnia to szybki i wygodny mechanizm udostępniania i ponownego używania ustawień kontrolek serwera oraz zapewnia deweloperom możliwość kontrolowania wyglądu i zachowania eksportowanych i importowanych kontrolek.

Właściwości w elemecie webPart nie są domyślnie eksportowane. Aby włączyć eksportowanie właściwości, należy oznaczyć ją atrybutem [Personalizable] w kodzie źródłowym. Opcjonalnie możesz również oznaczyć właściwość, którą można wyeksportować jako zawierającą poufne dane, ustawiając isSensitive parametr atrybutu [Personalizable] na true. Domyślnie isSensitive jest to false. Deweloperzy mogą ustawić parametr , aby wskazać true , że dane są poufne.

Aby umożliwić webPart eksportowanie, deweloper ustawia jego ExportMode wartość właściwości na All wartość (która zawiera wszystkie właściwości personalizowalne i poufne) lub na NonSensitiveDatawartość , która eksportuje wszystko z wyjątkiem właściwości poufnych.

Ważne

Umożliwienie użytkownikom eksportowania danych z kontrolek i importowanie danych do innych mechanizmów kontroli wiąże się z pewnymi zagrożeniami bezpieczeństwa. Deweloperzy powinni użyć opisanego powyżej podejścia do ochrony poufnych danych, a jeśli chcą uniknąć ryzyka całkowitego ujawnienia danych, nie powinni w ogóle włączać eksportu webPart . Aby uzyskać szczegółowe informacje na temat problemów z zabezpieczeniami składników Web Part, zobacz Zabezpieczanie stron składników Web Part.

Dotyczy

Udostępnij za pośrednictwem