ImportCatalogPart.UploadHelpText Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit le texte du message qui explique à l'utilisateur comment transférer un fichier de description.

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

Valeur de propriété

String

Chaîne utilisée comme instructions pour l'utilisateur pour transférer un fichier de description. 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 UploadHelpText 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é UploadHelpText 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 UploadHelpText 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 UploadHelpText propriété.

Remarques

La UploadHelpText propriété fournit une brève phrase ou une phrase d’instructions pour les utilisateurs, leur demandant de cliquer sur un bouton pour charger le fichier de description. Si vous affectez du texte personnalisé à cette propriété ou à la UploadButtonText 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.

S’applique à

Voir aussi

contrôles webPart ASP.NET

Partager via