ImportCatalogPart.UploadHelpText プロパティ

定義

名前空間:

System.Web.UI.WebControls.WebParts

アセンブリ:

System.Web.dll

ユーザーに記述ファイルをアップロードする方法を通知するメッセージのテキストを取得または設定します。

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

public string UploadHelpText { get; set; }

member this.UploadHelpText : string with get, set

Public Property UploadHelpText As String

プロパティ値

String

ユーザーが記述ファイルをアップロードするときの指示として使用される文字列。 既定値は、Web パーツ コントロール セットによって提供されるカルチャ固有の文字列です。

例

次のコード例では、 プロパティを宣言的およびプログラム的に使用 UploadHelpText する方法を示します。 この例を実行するために必要な完全なコードと手順については、クラスの概要の「例」セクションを ImportCatalogPart 参照してください。

コードの次のセクションでは、プロパティ値がコントロールに対して UploadHelpText 宣言的に設定されていることに注意してください。

<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>

<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>

コードのこのセクションでは、プロパティ値 UploadHelpText がプログラムによって割り当てられます。

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 occurred " 
    + "during the import process.";

}

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 occurred " _
      & "during the import process."
End Sub

ブラウザーでページを読み込むときは、[ 表示モード ] ドロップダウン リスト コントロールを使用して [ カタログ モード ] を選択し、ページをカタログ モードに切り替えることができます。 カタログ モードのページと説明ファイルをアップロードした状態で、コントロールのユーザー インターフェイス (UI) に表示されるさまざまなテキスト文字列を ImportCatalogPart メモします。 [ 説明ファイルのアップロード ] ボタンをクリックすると、UI 内のいくつかのプロパティのテキスト (プロパティのテキストを含む) が UploadHelpText 変更されます。

注釈

プロパティは UploadHelpText 、説明ファイルをアップロードするボタンをクリックするようにユーザーに指示する、簡単な文または手順のフレーズを提供します。 このプロパティまたは UploadButtonText プロパティにカスタム テキストを割り当てる場合、テキストはユーザーが説明ファイルをアップロードしていることを明確にする必要があります。 テキストは、アップロード プロセスが実際にコントロール自体をアップロードしていることを示すものではありません。

こちらもご覧ください

• ASP.NET Web パーツ コントロール