ImportCatalogPart.PartImportErrorLabelText プロパティ

.NET Framework クラス ライブラリ リファレンス

ImportCatalogPart.PartImportErrorLabelText プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

インポート プロセスでエラーが発生した場合に表示されるエラー メッセージを取得または設定します。

名前空間: System.Web.UI.WebControls.WebParts
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Property PartImportErrorLabelText As
 String

Visual Basic (使用法)

Dim instance As ImportCatalogPart
Dim value As String

value = instance.PartImportErrorLabelText

instance.PartImportErrorLabelText = value

C#

public string PartImportErrorLabelText { get;
 set; }

C++

public:
property String^ PartImportErrorLabelText {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_PartImportErrorLabelText ()

/** @property */
public void set_PartImportErrorLabelText (String
 value)

JScript

public function get PartImportErrorLabelText
 () : String

public function set PartImportErrorLabelText
 (value : String)

プロパティ値
ラベルのテキストを含む文字列。既定値は、.NET Framework が提供する、カルチャ固有の文字列です。

解説

PartImportErrorLabelText プロパティは、ページが記述ファイルをインポートしようとしたときに問題またはエラーが発生した場合に、ユーザーに通知するのに便利です。

使用例

PartImportErrorLabelText プロパティの使用方法を次のコード例に示します。宣言を使用した方法とプログラムを使用した方法の 2 とおりの方法を紹介します。例の実行に必要なコード全体については、ImportCatalogPart クラスの概要の「例」を参照してください。

次のコードのセクションでは、コントロールの PartImportErrorLabelText プロパティ値が宣言で設定されます。

Visual Basic

<asp:CatalogZone ID="CatalogZone1" runat="server">
  <ZoneTemplate>
    <asp:ImportCatalogPart ID="ImportCatalogPart1"
 
      runat="server" 
      Title="My ImportCatalogPart" 
      OnPreRender="ImportCatalogPart1_PreRender"
      BrowseHelpText="Type a path or browse to
 find a control's 
        description file." 
      UploadButtonText="Upload Description File" 
      UploadHelpText="Click the button to upload the description
 
        file."
      ImportedPartLabelText="My User Information WebPart"
 
      PartImportErrorLabelText="An error occurred while
 trying 
        to import a description file."  />
  </ZoneTemplate>
</asp:CatalogZone>

C#

<asp:CatalogZone ID="CatalogZone1" runat="server">
  <ZoneTemplate>
    <asp:ImportCatalogPart ID="ImportCatalogPart1" 
      runat="server" 
      Title="My ImportCatalogPart" 
      OnPreRender="ImportCatalogPart1_PreRender"
      BrowseHelpText="Type a path or browse to find a control's 
        description file." 
      UploadButtonText="Upload Description File" 
      UploadHelpText="Click the button to upload the description 
        file."
      ImportedPartLabelText="My User Information WebPart" 
      PartImportErrorLabelText="An error occurred while trying
 
        to import a description file."  />
  </ZoneTemplate>
</asp:CatalogZone>

このコードのセクションでは、PartImportErrorLabelText プロパティ値がプログラムで代入されます。

Visual Basic

Protected Sub Button1_Click(ByVal
 sender As Object, _
  ByVal e As EventArgs)
    ImportCatalogPart1.Title = "Import Server Controls"
    ImportCatalogPart1.BrowseHelpText = "Enter the path to a "
 _
      & "description file."
    ImportCatalogPart1.UploadButtonText = "Upload Description"
    ImportCatalogPart1.UploadHelpText = "Upload a description
 file."
    ImportCatalogPart1.ImportedPartLabelText = "Imported Controls"
    ImportCatalogPart1.PartImportErrorLabelText = "An error occured
 " _
      & "during the import process."
End Sub

C#

protected void Button1_Click(object sender,
 EventArgs e)
{
  ImportCatalogPart1.Title = "Import Server Controls";
  ImportCatalogPart1.BrowseHelpText = "Enter the path to a "
    + "description file.";
  ImportCatalogPart1.UploadButtonText = "Upload Description";
  ImportCatalogPart1.UploadHelpText = "Upload a description file.";
  ImportCatalogPart1.ImportedPartLabelText = "Imported Controls";
  ImportCatalogPart1.PartImportErrorLabelText = "An error occured " 
    + "during the import process.";

}

ブラウザでページを読み込む場合は、[Display Mode] ドロップダウン リスト コントロールを使って [Catalog Mode] を選択し、ページをカタログ モードに切り替えることができます。ページがカタログ モードのとき、記述ファイルがアップロードされている場合は、ImportCatalogPart コントロールのユーザー インターフェイス (UI) に各種のテキスト文字列が表示される点に注意してください。[Upload Description File] ボタンをクリックすると、PartImportErrorLabelText プロパティのテキストなど、UI の一部のプロパティのテキストが変更されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ImportCatalogPart クラス
ImportCatalogPart メンバ
System.Web.UI.WebControls.WebParts 名前空間
その他の技術情報
ASP.NET Web パーツ ページ