ImportCatalogPart.UploadHelpText Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls.WebParts
Assemblagem:
System.Web.dll

Obtém ou define o texto da mensagem que indica ao utilizador como carregar um ficheiro de descrição.

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

Valor de Propriedade

String

Uma cadeia que serve de instruções para o utilizador carregar um ficheiro de descrição. O valor padrão é uma cadeia específica de cultura fornecida pelo conjunto de controlo Web Parts.

Exemplos

O exemplo de código seguinte demonstra como usar a UploadHelpText propriedade de forma declarativa e programática. Para o código completo e as instruções necessárias para executar o exemplo, consulte a secção Exemplo da ImportCatalogPart visão geral da classe.

Na secção seguinte do código, note que o UploadHelpText valor da propriedade é definido declarativamente para o controlo.

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

Nesta secção do código, o UploadHelpText valor da propriedade é atribuído programaticamente.

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

Quando carrega a página num navegador, pode usar o controlo de lista suspensa do Modo de Exibição para selecionar o Modo Catálogo e mudar a página para o modo catálogo. Com a página em modo catálogo e o ficheiro de descrição carregado, note as várias cadeias de texto exibidas na interface de utilizador (UI) do ImportCatalogPart controlo. Se clicar no botão Carregar Ficheiro de Descrição , o texto de várias propriedades na interface é alterado, incluindo o texto da UploadHelpText propriedade.

Observações

A UploadHelpText propriedade fornece uma breve frase ou instruções para os utilizadores, dizendo-lhes para clicarem num botão para carregar o ficheiro de descrição. Se atribuir texto personalizado a esta propriedade, ou à propriedade UploadButtonText , o texto deve deixar claro que o utilizador está a carregar um ficheiro de descrição. O texto não deve dizer ou sugerir que o processo de upload está realmente a carregar o controlo em si.

Aplica-se a

Ver também