ImportCatalogPart.UploadButtonText Propriété

Définition

Espace de noms:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Obtient ou définit le texte pour le contrôle Button qui initialise le transfert d'un fichier de description.

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

Valeur de propriété

String

Chaîne utilisée comme texte pour Button. La valeur par défaut est une chaîne propre à la culture fournie par le jeu de contrôles WebPart.

Exemples

L’exemple de code suivant montre comment utiliser la UploadButtonText propriété de manière déclarative et programmatique. Pour obtenir le code complet et les instructions nécessaires à l’exécution de l’exemple, consultez la section Exemple de la vue d’ensemble de la ImportCatalogPart classe.

Dans la section suivante du code, notez que la valeur de propriété UploadButtonText est définie de manière déclarative pour le contrôle.

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

Dans cette section de code, la valeur de la UploadButtonText propriété est affectée par programmation.

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

Lorsque vous chargez la page dans un navigateur, vous pouvez utiliser le contrôle de liste déroulante Mode d’affichage pour sélectionner Mode catalogue et basculer la page en mode catalogue. Une fois la page en mode catalogue et le fichier de description chargé, notez les différentes chaînes de texte affichées dans l’interface utilisateur du ImportCatalogPart contrôle. Si vous cliquez sur le bouton Charger le fichier de description , le texte de plusieurs propriétés de l’interface utilisateur est modifié, y compris le texte de la UploadButtonText propriété.

Remarques

La UploadButtonText propriété fournit le texte du Button contrôle qui lance le processus de chargement. Si vous affectez du texte personnalisé à cette propriété ou à la UploadHelpText propriété, le texte doit indiquer clairement que l’utilisateur charge un fichier de description. Le texte ne doit pas indiquer ou impliquer que le processus de chargement est en train de charger le contrôle lui-même.

Voir aussi

• contrôles webPart ASP.NET