ImportCatalogPart.BrowseHelpText Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta un messaggio di testo che indica agli utenti di selezionare il percorso di un file di descrizione.

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

public string BrowseHelpText { get; set; }

member this.BrowseHelpText : string with get, set

Public Property BrowseHelpText As String

Valore della proprietà

String

Stringa che contiene il testo del messaggio. Il valore predefinito è un messaggio specifico delle impostazioni cultura fornito in .NET Framework.

Esempio

Nell'esempio di codice seguente viene illustrato come usare la BrowseHelpText proprietà in modo dichiarativo e a livello di codice. Per il codice completo e le istruzioni necessarie per eseguire l'esempio, vedere la sezione Esempio della panoramica della ImportCatalogPart classe.

Nella sezione di codice seguente si noti che il valore della BrowseHelpText proprietà viene impostato in modo dichiarativo per il controllo .

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

In questa sezione di codice il valore della BrowseHelpText proprietà viene assegnato a livello di codice.

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 si carica la pagina in un browser, è possibile usare il controllo elenco a discesa Modalità di visualizzazione per selezionare Modalità catalogo e passare alla modalità catalogo. Con la pagina in modalità catalogo e il file di descrizione caricati, prendere nota delle varie stringhe di testo visualizzate nell'interfaccia utente per il ImportCatalogPart controllo. Se si fa clic sul pulsante Carica file descrizione , viene modificato il testo per diverse proprietà dell'interfaccia utente, incluso il testo per la BrowseHelpText proprietà .

Commenti

La BrowseHelpText proprietà offre agli utenti una semplice panoramica della prima operazione da eseguire nel processo di aggiunta di un controllo importato: fornire il percorso di un file di descrizione digitando un percorso o passando al file. Un motivo tipico per fornire un valore personalizzato per questa proprietà è se sono disponibili istruzioni speciali per gli utenti, ad esempio una condivisione di rete specifica a cui devono cercare per individuare un file di descrizione.

Si applica a

Vedi anche

controlli web part ASP.NET

Condividi tramite