WebPartManager.ExportWebPart(WebPart, XmlWriter) メソッド

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls.WebParts
アセンブリ:
System.Web.dll

サーバー コントロールの状態データとプロパティ データが格納された XML 記述ファイルを作成します。

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)

パラメーター

webPart
WebPart

データのエクスポート元となるコントロール。

writer
XmlWriter

エクスポートされたデータを webPart から XML 記述ファイルに書き込む XmlWriter。

例外

ArgumentNullException

webPart が nullです。

または

writer が nullです。

ArgumentException

webPart が、Controls で参照されるコントロールのコレクションに格納されていません。

- または -

webPart の ExportMode プロパティが、None の値に設定されています。これは、webPart のエクスポートが無効になっていることを示します。

注釈

メソッドは ExportWebPart 、さまざまな状態データとプロパティ データを XML webPart ファイルにアセンブルします。 データには、アセンブリ、状態データ、プロパティ データなど、コントロール自体に関する情報が含まれます。 エクスポートを開始するユーザーは、ローカル コンピューターまたはネットワーク上のディスクに XML ファイルを保存できます。 その後、他のユーザーは、説明ファイルを別のページまたは Web サイトにインポートし、状態データとプロパティ データを の別の webPartインスタンスに適用できます。 これにより、ユーザーがサーバー コントロールの設定を共有して再利用するための高速で便利なメカニズムが提供されます。また、開発者は、エクスポートおよびインポートされたコントロールの外観と動作を制御する手段も提供します。

の webPart プロパティは、既定ではエクスポートされません。 プロパティのエクスポートを有効にするには、ソース コードの 属性で [Personalizable] マークする必要があります。 必要に応じて、 属性trueの パラメーターを に設定isSensitiveすることで、エクスポート可能なプロパティを機密データを[Personalizable]含むものとしてマークすることもできます。 既定では、isSensitive は false です。 開発者は、 パラメーターを に true 設定して、データが機密であることを示すことができます。

有効にするwebPart開発者の設定をエクスポートするには、そのExportModeプロパティの値をいずれかAll(を含む、すべてのパーソナル化できると機微なプロパティです、) またはNonSensitiveData、機微なプロパティを除くすべてをエクスポートします。

重要

ユーザーがコントロールからデータをエクスポートしたり、他のコントロールにデータをインポートしたりできるようにするには、セキュリティ上のリスクが伴います。 開発者は、上で説明したアプローチを使用して機密データを保護する必要があります。また、データを完全に公開するリスクを回避したい場合は、エクスポートをまったく有効に webPart しないでください。 Web パーツのセキュリティの問題の詳細については、「 Web パーツ ページのセキュリティ保護」を参照してください。

適用対象

こちらもご覧ください