ImportCatalogPart.UploadHelpText Propriété

  • Référence

Définition

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

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 pour exécuter 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 la UploadHelpText propriété 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 programme.

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 indiquant 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 charge le contrôle lui-même.

S’applique à

Voir aussi