ImportCatalogPart.UploadButtonText Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Ruft den Text für das Button-Steuerelement ab, das das Hochladen einer Beschreibungsdatei startet, oder legt diesen fest.

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

public string UploadButtonText { get; set; }

member this.UploadButtonText : string with get, set

Public Property UploadButtonText As String

Eigenschaftswert

String

Eine Zeichenfolge, die als Text für einen Button verwendet wird. Der Standardwert ist eine vom Webparts-Steuerelementsatz bereitgestellte kulturspezifische Zeichenfolge.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die UploadButtonText Eigenschaft deklarativ und programmgesteuert verwendet wird. Den vollständigen Code und die 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 UploadButtonText 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 UploadButtonText 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 Dropdown-Listensteuerelement 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, beachten Sie die verschiedenen Textzeichenfolgen, die auf 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 in der Benutzeroberfläche geändert, einschließlich des Texts für die UploadButtonText Eigenschaft.

Hinweise

Die UploadButtonText -Eigenschaft stellt den Text für das Button Steuerelement bereit, das den Uploadvorgang initiiert. Wenn Sie dieser Eigenschaft oder der UploadHelpText Eigenschaft benutzerdefinierten Text zuweisen, sollte der Text deutlich machen, dass der Benutzer eine Beschreibungsdatei hochlädt. Der Text sollte nicht sagen oder implizieren, dass der Uploadprozess tatsächlich das Steuerelement selbst hochlädt.

Weitere Informationen

• ASP.NET Webparts-Steuerelemente