ImportCatalogPart.BrowseHelpText Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft eine Textmeldung ab, die Benutzer auffordert, in das Verzeichnis einer Beschreibungsdatei zu wechseln, oder legt diese Textmeldung fest.

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

Eigenschaftswert

String

Eine Zeichenfolge, die den Text der Meldung enthält. Der Standardwert ist eine von .NET Framework bereitgestellte kulturspezifische Meldung.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die BrowseHelpText Eigenschaft deklarativ und programmgesteuert verwendet wird. Den vollständigen Code und anweisungen, die zum Ausführen des Beispiels erforderlich sind, finden Sie im Abschnitt Beispiel der ImportCatalogPart Klassenübersicht.

Beachten Sie im folgenden Codeabschnitt, dass der BrowseHelpText Eigenschaftswert deklarativ für das Steuerelement festgelegt wird.

<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 diesem Codeabschnitt wird der BrowseHelpText Eigenschaftswert programmgesteuert zugewiesen.

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

Wenn Sie die Seite in einem Browser laden, können Sie das Dropdownlistensteuerelement Anzeigemodus verwenden, um den Katalogmodus auszuwählen und die Seite in den Katalogmodus zu wechseln. Wenn die Seite im Katalogmodus und die Beschreibungsdatei hochgeladen wurden, notieren Sie sich die verschiedenen Textzeichenfolgen, die in der Benutzeroberfläche (UI) für das ImportCatalogPart Steuerelement angezeigt werden. Wenn Sie auf die Schaltfläche Beschreibungsdatei hochladen klicken, wird der Text für mehrere Eigenschaften auf der Benutzeroberfläche geändert, einschließlich des Texts für die BrowseHelpText Eigenschaft.

Hinweise

Die BrowseHelpText -Eigenschaft gibt Benutzern einen einfachen Überblick über das erste, was sie beim Hinzufügen eines importierten Steuerelements tun müssen: Geben Sie den Speicherort einer Beschreibungsdatei an, indem Sie entweder einen Pfad eingeben oder zur Datei navigieren. Ein typischer Grund für die Bereitstellung eines benutzerdefinierten Werts für diese Eigenschaft ist, wenn Sie spezielle Anweisungen für Benutzer haben, z. B. eine bestimmte Netzwerkfreigabe, zu der sie navigieren sollten, um nach einer Beschreibungsdatei zu suchen.

Gilt für:

Weitere Informationen

ASP.NET Webpart-Steuerelemente