ImportCatalogPart.BrowseHelpText Propriété

  • Référence

Définition

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

Obtient ou définit un message texte qui demande aux utilisateurs d'accéder à l'emplacement d'un fichier de description.

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

Valeur de propriété

String

Chaîne qui contient le texte du message. La valeur par défaut est un message propre à la culture fourni par le .NET Framework.

Exemples

L’exemple de code suivant montre comment utiliser la BrowseHelpText 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 BrowseHelpText 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 BrowseHelpText 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 BrowseHelpText propriété.

Remarques

La BrowseHelpText propriété donne aux utilisateurs une vue d’ensemble simple de la première chose qu’ils doivent faire dans le processus d’ajout d’un contrôle importé : fournir l’emplacement d’un fichier de description, en tapant un chemin d’accès ou en accédant au fichier. Une raison typique de fournir une valeur personnalisée pour cette propriété est si vous avez des instructions spéciales pour les utilisateurs, par exemple un partage réseau spécifique vers lequel ils doivent parcourir pour localiser un fichier de description.

S’applique à

Voir aussi