ImportCatalogPart.UploadHelpText Propiedad

Definición

Espacio de nombres:

System.Web.UI.WebControls.WebParts

Ensamblado:

System.Web.dll

Obtiene o establece el texto del mensaje que indica al usuario cómo cargar un archivo de descripción.

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 propiedad

String

Una cadena utilizada como instrucciones para que el usuario pueda cargar un archivo de descripción. El valor predeterminado es una cadena específica de la referencia cultural proporcionada por el conjunto de controles de elementos Web.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la UploadHelpText propiedad mediante declaración y mediante programación. Para obtener el código completo y las instrucciones necesarias para ejecutar el ejemplo, consulte la sección Ejemplo de la información general de la ImportCatalogPart clase.

En la siguiente sección de código, observe que el valor de propiedad UploadHelpText se establece declarativamente para el control .

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

En esta sección de código, el valor de la UploadHelpText propiedad se asigna mediante programación.

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

Al cargar la página en un explorador, puede usar el control de lista desplegable Modo de presentación para seleccionar Modo de catálogo y cambiar la página al modo de catálogo. Con la página en modo de catálogo y el archivo de descripción cargado, anote las distintas cadenas de texto que se muestran en la interfaz de usuario (UI) del ImportCatalogPart control. Si hace clic en el botón Cargar archivo de descripción , se cambia el texto de varias de las propiedades de la interfaz de usuario, incluido el texto de la UploadHelpText propiedad .

Comentarios

La UploadHelpText propiedad proporciona una breve frase o frase de instrucciones para los usuarios, indicándoles que haga clic en un botón para cargar el archivo de descripción. Si asigna texto personalizado a esta propiedad o a la UploadButtonText propiedad , el texto debe aclarar que el usuario está cargando un archivo de descripción. El texto no debe decir ni implicar que el proceso de carga está cargando realmente el propio control.

Consulte también

• controles de elementos web de ASP.NET