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 部件控件