DataGridHyperlinkColumn Classe

Définition

Représente une colonne DataGrid qui héberge des éléments Uri dans ses cellules.Represents a DataGrid column that hosts Uri elements in its cells.

public ref class DataGridHyperlinkColumn : System::Windows::Controls::DataGridBoundColumn
public class DataGridHyperlinkColumn : System.Windows.Controls.DataGridBoundColumn
type DataGridHyperlinkColumn = class
    inherit DataGridBoundColumn
Public Class DataGridHyperlinkColumn
Inherits DataGridBoundColumn
Héritage

Exemples

L’exemple suivant montre un DataGridHyperlinkColumn qui définit Uri avec la Binding propriété et le texte du lien hypertexte avec la ContentBinding propriété.The following example shows a DataGridHyperlinkColumn that sets the Uri with the Binding property and the hyperlink text with the ContentBinding property. L' Hyperlink.Click événement est géré automatiquement, car NavigationWindow est le parent de DataGrid .The Hyperlink.Click event is handled automatically because NavigationWindow is the parent of the DataGrid.

<NavigationWindow x:Class="DataGrid_CustomColumns.Window1"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:core="clr-namespace:System;assembly=mscorlib"
    xmlns:local="clr-namespace:DataGrid_CustomColumns"
    Title="Customers" Height="300" Width="300" ShowsNavigationUI="False"  >
    
<NavigationWindow.Resources>
    <!--Create an instance of the converter for Email-->
    <local:EmailConverter x:Key="EmailConverter" />
</NavigationWindow.Resources>
<NavigationWindow.Content>  
    
<Grid>
    <DataGrid Name="DG1" ItemsSource="{Binding}" AutoGenerateColumns="False" >
        <DataGrid.Columns>
<!--The Email property contains a URI.  For example "mailto:lucy0@adventure-works.com"-->
<DataGridHyperlinkColumn Header="Email" Binding="{Binding Email}"  ContentBinding="{Binding Email, Converter={StaticResource EmailConverter}}" />
            </DataGrid.Columns>
        </DataGrid>
    </Grid>
    </NavigationWindow.Content>
</NavigationWindow>
public partial class Window1 : NavigationWindow
{
Class Window1
public Window1()
{
    InitializeComponent();

    //GetData() creates a collection of Customer data from a database
    ObservableCollection<Customer> custdata = GetData();
    
    //Bind the DataGrid to the customer data
    DG1.DataContext = custdata;
}
Public Sub New()
    ' This call is required by the Windows Form Designer.
    InitializeComponent()
    ' Add any initialization after the InitializeComponent() call.

    'GetData() creates a collection of Customer data from a database
    Dim custdata As ObservableCollection(Of Customer) = GetData()

    'Bind the DataGrid to the customer data
    DG1.DataContext = custdata

End Sub
//Defines the customer object
public class Customer
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public Uri Email { get; set; }
    public bool IsMember { get; set; }
    public OrderStatus Status { get; set; }
}
'Defines the customer object
Public Class Customer
    Public Property FirstName() As String
    Public Property LastName() As String
    Public Property Email() As Uri
    Public Property IsMember() As Boolean
    Public Property Status() As OrderStatus
End Class
}
End Class
//Converts the mailto uri to a string with just the customer alias
public class EmailConverter : IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture)
    {
        if (value != null)
        {
            string email = value.ToString();
            int index = email.IndexOf("@");
            string alias = email.Substring(7, index-7);
            return alias;
        }
        else
        {
            string email = "";
            return email;
        }
    }

    public object ConvertBack(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture)
    {
        Uri email = new Uri((string)value);
        return email;
    }
}
'Converts the mailto uri to a string with just the customer alias
Public Class EmailConverter
    Implements IValueConverter

    Public Function Convert(value As Object, targetType As System.Type, parameter As Object, culture As System.Globalization.CultureInfo) As Object Implements System.Windows.Data.IValueConverter.Convert
        If value IsNot Nothing Then
            Dim email As String = value.ToString()
            Dim index As Integer = email.IndexOf("@")
            Dim [alias] As String = email.Substring(7, index - 7)
            Return [alias]
        Else
            Dim email As String = ""
            Return email
        End If
    End Function

    Public Function ConvertBack(value As Object, targetType As System.Type, parameter As Object, culture As System.Globalization.CultureInfo) As Object Implements System.Windows.Data.IValueConverter.ConvertBack
        Dim email As New Uri(DirectCast(value, String))
        Return email
    End Function
End Class

Remarques

Utilisez DataGridHyperlinkColumn pour afficher des données qui contiennent un Uri , par exemple une adresse http ou une adresse de messagerie.Use DataGridHyperlinkColumn to display data that contains a Uri, such as an HTTP address or email address. L’illustration suivante montre un exemple de DataGridHyperlinkColumn .The following illustration shows an example of a DataGridHyperlinkColumn.

DataGridHyperlinkColumn avec adresses de messagerieDataGridHyperlinkColumn with email addresses

Notes

Hyperlink la navigation ne peut se produire que si le parent direct ou indirect d’un Hyperlink est un hôte de navigation.Hyperlink navigation can only occur if either the direct or indirect parent of a Hyperlink is a navigation host. Les exemples d’hôtes de navigation incluent NavigationWindow , Frame ou tout navigateur qui peut héberger XBAPXBAPs , tel que Microsoft Internet Explorer 6Microsoft Internet Explorer 6 ou version ultérieure, et Firefox 2,0 ou version ultérieure.Examples of navigation hosts include NavigationWindow, Frame, or any browser that can host XBAPXBAPs, such as Microsoft Internet Explorer 6Microsoft Internet Explorer 6 or later and Firefox 2.0 or later. Pour plus d’informations, consultez la rubrique « hôtes de navigation » dans vue d’ensemblede la navigation.For more information, see the "Navigation Hosts" topic in Navigation Overview.

Pour remplir la colonne, liez la colonne aux données à l' Uri aide de la Binding propriété.To populate the column, bind the column to the Uri data by using the Binding property. Pour afficher un texte de lien hypertexte différent de la chaîne d’URI, liez la valeur de texte à la ContentBinding propriété.To display hyperlink text that is different than the URI string, bind the text value to the ContentBinding property. La Binding propriété est appliquée à l' Hyperlink TextBox élément ou créé dans la colonne.The Binding property is applied to the Hyperlink or TextBox element created in the column. DataContextPour l’élément de chaque cellule, est l’élément de données de la ligne dans laquelle se trouve la cellule.The DataContext for the element in each cell is the data item for the row the cell is in. Par conséquent, pour configurer la liaison, vous devez uniquement définir Binding.Path .Therefore, to set up the binding you only have to set the Binding.Path. Éventuellement, vous pouvez spécifier un Binding.Converter si vous souhaitez convertir les données.Optionally, you can specify a Binding.Converter if you want to convert the data. Pour plus d’informations sur la liaison de données, consultez liaison de données (WPF).For more information about data binding, see Data Binding (WPF).

Notes

DataGridHyperlinkColumn crée un Hyperlink élément en mode sans modification et un TextBox élément en mode édition.DataGridHyperlinkColumn creates a Hyperlink element in the non-editing mode and a TextBox element in the editing mode.

Si vous souhaitez afficher d’autres types de données, DataGrid fournit les types de colonnes suivants :If you want to display other types of data, DataGrid provides the following column types:

Type de colonneColumn Type Affichage des donnéesData Display
DataGridCheckBoxColumn Utilisez pour afficher des données booléennes.Use to display Boolean data.
DataGridComboBoxColumn Utilisez pour afficher les données d’énumération.Use to display enumeration data.
DataGridTextColumn Utilisez pour afficher le texte.Use to display text.

Si vous souhaitez utiliser d’autres contrôles dans votre DataGrid , vous pouvez créer vos propres types de colonnes à l’aide de DataGridTemplateColumn .If you want to use other controls in your DataGrid, you can create your own column types by using DataGridTemplateColumn.

Constructeurs

DataGridHyperlinkColumn()

Initialise une nouvelle instance de la classe DataGridHyperlinkColumn.Initializes a new instance of the DataGridHyperlinkColumn class.

Champs

TargetNameProperty

Identifie la propriété de dépendance TargetName.Identifies the TargetName dependency property.

Propriétés

ActualWidth

Obtient la largeur actuelle de la colonne en unités indépendantes des appareils (1/96e de pouce par unité)device-independent units (1/96th inch per unit).Gets the current width of the column, in unités indépendantes des appareils (1/96e de pouce par unité)device-independent units (1/96th inch per unit).

(Hérité de DataGridColumn)
Binding

Obtient ou définit la liaison qui associe la colonne à une propriété dans la source de données.Gets or sets the binding that associates the column with a property in the data source.

(Hérité de DataGridBoundColumn)
CanUserReorder

Obtient ou définit une valeur qui indique si l'utilisateur peut modifier la position d'affichage des colonnes en faisant glisser leur en-tête.Gets or sets a value that indicates whether the user can change the column display position by dragging the column header.

(Hérité de DataGridColumn)
CanUserResize

Obtient ou définit une valeur qui indique si l'utilisateur peut ajuster la largeur de colonne à l'aide de la souris.Gets or sets a value that indicates whether the user can adjust the column width by using the mouse.

(Hérité de DataGridColumn)
CanUserSort

Obtient ou définit une valeur qui indique si l'utilisateur peut trier la colonne en cliquant sur son en-tête.Gets or sets a value that indicates whether the user can sort the column by clicking the column header.

(Hérité de DataGridColumn)
CellStyle

Obtient ou définit le style qui est utilisé lors du rendu des cellules de la colonne.Gets or sets the style that is used to render cells in the column.

(Hérité de DataGridColumn)
ClipboardContentBinding

Obtient ou définit l'objet de liaison à utiliser lors de l'obtention ou de la définition du contenu de cellule pour le Presse-papiers.Gets or sets the binding object to use when getting or setting cell content for the clipboard.

(Hérité de DataGridBoundColumn)
ContentBinding

Obtient ou définit la liaison au texte du lien hypertexte.Gets or sets the binding to the text of the hyperlink.

DataGridOwner

Obtient le contrôle DataGrid qui contient cette colonne.Gets the DataGrid control that contains this column.

(Hérité de DataGridColumn)
DefaultEditingElementStyle

Valeur par défaut de la propriété EditingElementStyle.The default value of the EditingElementStyle property.

DefaultElementStyle

Valeur par défaut de la propriété ElementStyle.The default value of the ElementStyle property.

DependencyObjectType

Obtient le DependencyObjectType qui encapsule le type CLRCLR de cette instance.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Hérité de DependencyObject)
Dispatcher

Obtient le Dispatcher associé à DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Hérité de DispatcherObject)
DisplayIndex

Obtient ou définit la position d'affichage de la colonne par rapport aux autres colonnes dans le DataGrid.Gets or sets the display position of the column relative to the other columns in the DataGrid.

(Hérité de DataGridColumn)
DragIndicatorStyle

Obtient ou définit l'objet de style à appliquer à l'en-tête de colonne lors d'une opération glisser.Gets or sets the style object to apply to the column header during a drag operation.

(Hérité de DataGridColumn)
EditingElementStyle

Obtient ou définit le style utilisé lors du rendu de l'élément que la colonne affiche pour une cellule en mode édition.Gets or sets the style that is used when rendering the element that the column displays for a cell in editing mode.

(Hérité de DataGridBoundColumn)
ElementStyle

Obtient ou définit le style utilisé lors du rendu de l'élément que la colonne affiche pour une cellule qui n'est pas en mode édition.Gets or sets the style that is used when rendering the element that the column displays for a cell that is not in editing mode.

(Hérité de DataGridBoundColumn)
Header

Obtient ou définit le contenu de l'en-tête de la colonne.Gets or sets the content of the column header.

(Hérité de DataGridColumn)
HeaderStringFormat

Obtient ou définit le modèle de format à appliquer au contenu de l'en-tête de colonne.Gets or sets the format pattern to apply to the content of the column header.

(Hérité de DataGridColumn)
HeaderStyle

Obtient ou définit le style utilisé lors du rendu de l'en-tête de colonne.Gets or sets the style that is used when rendering the column header.

(Hérité de DataGridColumn)
HeaderTemplate

Obtient ou définit le modèle qui définit la représentation visuelle de l'en-tête de colonne.Gets or sets the template that defines the visual representation of the column header.

(Hérité de DataGridColumn)
HeaderTemplateSelector

Obtient ou définit l'objet qui sélectionne le modèle utilisé pour l'en-tête de colonne.Gets or sets the object that selects which template to use for the column header.

(Hérité de DataGridColumn)
IsAutoGenerated

Obtient une valeur qui indique si la colonne est générée automatiquement.Gets a value that indicates whether the column is auto-generated.

(Hérité de DataGridColumn)
IsFrozen

Obtient une valeur qui indique si la colonne ne peut pas défiler horizontalement.Gets a value that indicates whether the column is prevented from scrolling horizontally.

(Hérité de DataGridColumn)
IsReadOnly

Obtient ou définit une valeur qui indique si les cellules de la colonne peuvent être modifiées.Gets or sets a value that indicates whether cells in the column can be edited.

(Hérité de DataGridColumn)
IsSealed

Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule).Gets a value that indicates whether this instance is currently sealed (read-only).

(Hérité de DependencyObject)
MaxWidth

Obtient ou définit la contrainte de largeur maximale applicable à la colonne.Gets or sets the maximum width constraint of the column.

(Hérité de DataGridColumn)
MinWidth

Obtient ou définit la contrainte de largeur minimale applicable à la colonne.Gets or sets the minimum width constraint of the column.

(Hérité de DataGridColumn)
SortDirection

Obtient ou définit le sens de tri (ascendant ou descendant) de la colonne.Gets or sets the sort direction (ascending or descending) of the column.

(Hérité de DataGridColumn)
SortMemberPath

Obtient ou définit un nom de propriété, ou une hiérarchie des noms de propriétés délimitée par des points, qui indique le membre utilisé pour le tri.Gets or sets a property name, or a period-delimited hierarchy of property names, that indicates the member to sort by.

(Hérité de DataGridColumn)
TargetName

Obtient ou définit le nom d'une fenêtre ou d'un frame cible pour le lien hypertexte.Gets or sets the name of a target window or frame for the hyperlink.

Visibility

Obtient ou définit la visibilité de la colonne.Gets or sets the visibility of the column.

(Hérité de DataGridColumn)
Width

Obtient ou définit la largeur de la colonne ou le mode de dimensionnement automatique.Gets or sets the column width or automatic sizing mode.

(Hérité de DataGridColumn)

Méthodes

CancelCellEdit(FrameworkElement, Object)

Fait en sorte que la cellule de colonne en cours de modification soit rétablie à la valeur spécifiée.Causes the column cell being edited to revert to the specified value.

CancelCellEdit(FrameworkElement, Object)

Permet de rétablir la cellule en cours de modification à sa valeur initiale non modifiée.Causes the cell being edited to revert to the original, unedited value.

(Hérité de DataGridColumn)
CheckAccess()

Détermine si le thread appelant a accès à ce DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Hérité de DispatcherObject)
ClearValue(DependencyProperty)

Efface la valeur locale d’une propriété.Clears the local value of a property. La propriété à effacer est spécifiée par un identificateur DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Hérité de DependencyObject)
ClearValue(DependencyPropertyKey)

Efface la valeur locale d’une propriété en lecture seule.Clears the local value of a read-only property. La propriété à effacer est spécifiée par DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Hérité de DependencyObject)
CoerceValue(DependencyProperty)

Convertit la valeur de la propriété de dépendance spécifiée.Coerces the value of the specified dependency property. Pour cela, on appelle toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le DependencyObject appelant.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Hérité de DependencyObject)
CommitCellEdit(FrameworkElement)

Exécute toute opération de validation requise avant de quitter le mode édition.Performs any required validation before exiting edit mode.

CommitCellEdit(FrameworkElement)

Exécute toute opération de validation requise avant de quitter le mode édition de la cellule.Performs any required validation before exiting cell editing mode.

(Hérité de DataGridColumn)
Equals(Object)

Détermine si un DependencyObject fourni est équivalent au DependencyObject réel.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Hérité de DependencyObject)
GenerateEditingElement(DataGridCell, Object)

Obtient un élément TextBox modifiable qui est lié à la valeur de propriété ContentBinding de la colonne.Gets an editable TextBox element that is bound to the column's ContentBinding property value.

GenerateElement(DataGridCell, Object)

Obtient un élément Hyperlink en lecture seule lié à la valeur de propriété ContentBinding de la colonne.Gets a read-only Hyperlink element that is bound to the column's ContentBinding property value.

GetCellContent(DataGridRow)

Récupère la valeur de propriété Content pour la cellule située à l'intersection de cette colonne et de la ligne spécifiée.Retrieves the Content property value for the cell at the intersection of this column and the specified row.

(Hérité de DataGridColumn)
GetCellContent(Object)

Obtient la valeur de la propriété Content pour la cellule à l'intersection de cette colonne et de la ligne qui représente l'élément de données spécifié.Gets the Content property value for the cell at the intersection of this column and the row that represents the specified data item.

(Hérité de DataGridColumn)
GetHashCode()

Obtient un code de hachage pour ce DependencyObject.Gets a hash code for this DependencyObject.

(Hérité de DependencyObject)
GetLocalValueEnumerator()

Crée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Hérité de DependencyObject)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
GetValue(DependencyProperty)

Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Hérité de DependencyObject)
InvalidateProperty(DependencyProperty)

Réévalue la valeur effective de la propriété de dépendance spécifiée.Re-evaluates the effective value for the specified dependency property.

(Hérité de DependencyObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
NotifyPropertyChanged(String)

Informe le DataGrid contenant cette colonne qu'une propriété de colonne a été modifiée.Notifies the DataGrid that contains this column that a column property has changed.

(Hérité de DataGridColumn)
OnBindingChanged(BindingBase, BindingBase)

Avertit DataGrid lorsque la valeur de la propriété Binding change.Notifies the DataGrid when the value of the Binding property changes.

(Hérité de DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)

Détermine la valeur de la propriété IsReadOnly en fonction des règles de propriété de la grille de données qui contient cette colonne.Determines the value of the IsReadOnly property based on property rules from the data grid that contains this column.

(Hérité de DataGridBoundColumn)
OnContentBindingChanged(BindingBase, BindingBase)

Informe le DataGrid lorsque la propriété ContentBinding change.Notifies the DataGrid when the ContentBinding property changes.

OnCopyingCellClipboardContent(Object)

Déclenche l’événement CopyingCellClipboardContent.Raises the CopyingCellClipboardContent event.

(Hérité de DataGridColumn)
OnPastingCellClipboardContent(Object, Object)

Déclenche l’événement PastingCellClipboardContent.Raises the PastingCellClipboardContent event.

(Hérité de DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Méthode appelée chaque fois que la valeur effective d’une propriété de dépendance sur ce DependencyObject a été mise à jour.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. La propriété de dépendance spécifique qui a changé est signalée dans les données d’événement.The specific dependency property that changed is reported in the event data.

(Hérité de DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)

Appelée lorsqu'une cellule de la colonne passe en mode édition.Called when a cell in the column enters editing mode.

ReadLocalValue(DependencyProperty)

Retourne la valeur locale d’une propriété de dépendance, si elle existe.Returns the local value of a dependency property, if it exists.

(Hérité de DependencyObject)
RefreshCellContent(FrameworkElement, String)

Actualise le contenu d'une cellule de la colonne en réponse à un changement de valeur de propriété de la colonne.Refreshes the contents of a cell in the column in response to a column property value change.

SetCurrentValue(DependencyProperty, Object)

Définit la valeur d’une propriété de dépendance sans modifier sa valeur source.Sets the value of a dependency property without changing its value source.

(Hérité de DependencyObject)
SetValue(DependencyProperty, Object)

Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance.Sets the local value of a dependency property, specified by its dependency property identifier.

(Hérité de DependencyObject)
SetValue(DependencyPropertyKey, Object)

Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Hérité de DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété de dépendance fournie.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Hérité de DependencyObject)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Hérité de Object)
VerifyAccess()

Garantit que le thread appelant a accès à DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Hérité de DispatcherObject)

Événements

CopyingCellClipboardContent

Se produit après la préparation du contenu du Presse-papiers de la cellule.Occurs after the cell clipboard content is prepared.

(Hérité de DataGridColumn)
PastingCellClipboardContent

Se produit avant le transfert du contenu du Presse-papiers dans la cellule.Occurs before the clipboard content is moved to the cell.

(Hérité de DataGridColumn)

S’applique à

Voir aussi