DataGridHyperlinkColumn Klas

Definitie

Naamruimte:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Vertegenwoordigt een DataGrid kolom die als host fungeert Uri voor elementen in de cellen.

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

Overname: Object

DispatcherObject

DependencyObject

DataGridColumn

DataGridBoundColumn
DataGridHyperlinkColumn

Voorbeelden

In het volgende voorbeeld ziet u een DataGridHyperlinkColumn voorbeeld waarmee de Uri Binding eigenschap en de hyperlinktekst met de ContentBinding eigenschap worden ingesteld. De Hyperlink.Click gebeurtenis wordt automatisch verwerkt omdat NavigationWindow het bovenliggende element van de DataGridgebeurtenis is.

<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

Opmerkingen

Hiermee DataGridHyperlinkColumn kunt u gegevens weergeven die een Uri, zoals een HTTP-adres of e-mailadres, bevatten. In de volgende afbeelding ziet u een voorbeeld van een DataGridHyperlinkColumn.

DataGridHyperlinkColumn met e-mailadressen

Note

Hyperlink navigatie kan alleen optreden als het directe of indirecte bovenliggende element van een Hyperlink een navigatiehost is. Voorbeelden van navigatiehosts zijn, NavigationWindow Frameof elke browser die XBAPs kan hosten. Zie het artikel 'Navigatiehosts' in Navigatieoverzicht voor meer informatie.

Zie Frequently asked questions about WPF browser-hosted applications (XBAP) voor meer informatie over XBAP-ondersteuning.

Als u de kolom wilt vullen, koppelt u de kolom aan de Uri gegevens met behulp van de Binding eigenschap. Als u hyperlinktekst wilt weergeven die anders is dan de URI-tekenreeks, koppelt u de tekstwaarde aan de ContentBinding eigenschap. De Binding eigenschap wordt toegepast op het Hyperlink of TextBox element dat in de kolom is gemaakt. Het DataContext element voor het element in elke cel is het gegevensitem voor de rij waarin de cel zich bevindt. Als u de binding wilt instellen, hoeft u dus alleen de Binding.Path. U kunt desgewenst een Binding.Converter gegevens opgeven als u de gegevens wilt converteren. Zie DataBinding (WPF) voor meer informatie over gegevensbinding.

Note

DataGridHyperlinkColumn maakt een Hyperlink element in de niet-bewerkingsmodus en een TextBox element in de bewerkingsmodus.

Als u andere typen gegevens wilt weergeven, DataGrid bevat u de volgende kolomtypen:

Kolomsoort	Gegevensweergave
DataGridCheckBoxColumn	Gebruik deze functie om Booleaanse gegevens weer te geven.
DataGridComboBoxColumn	Gebruik dit om opsommingsgegevens weer te geven.
DataGridTextColumn	Gebruik dit om tekst weer te geven.

Als u andere besturingselementen in uw DataGridwilt gebruiken, kunt u uw eigen kolomtypen maken met behulp van DataGridTemplateColumn.

Constructors

Name	Description
DataGridHyperlinkColumn()	Initialiseert een nieuw exemplaar van de DataGridHyperlinkColumn klasse.

Velden

Name	Description
TargetNameProperty	Identificeert de TargetName afhankelijkheidseigenschap.

Eigenschappen

Name	Description
ActualWidth	Hiermee haalt u de huidige breedte van de kolom op, in apparaatonafhankelijke eenheden (1/96e inch per eenheid). (Overgenomen van DataGridColumn)
Binding	Hiermee haalt u de binding op die de kolom koppelt aan een eigenschap in de gegevensbron of stelt u deze in. (Overgenomen van DataGridBoundColumn)
CanUserReorder	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de gebruiker de positie van de kolomweergave kan wijzigen door de kolomkop te slepen. (Overgenomen van DataGridColumn)
CanUserResize	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de gebruiker de kolombreedte kan aanpassen met behulp van de muis. (Overgenomen van DataGridColumn)
CanUserSort	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de gebruiker de kolom kan sorteren door op de kolomkop te klikken. (Overgenomen van DataGridColumn)
CellStyle	Hiermee haalt u de stijl op die wordt gebruikt om cellen in de kolom weer te geven of stelt u deze in. (Overgenomen van DataGridColumn)
ClipboardContentBinding	Hiermee wordt het bindingsobject opgehaald of ingesteld dat moet worden gebruikt bij het ophalen of instellen van celinhoud voor het klembord. (Overgenomen van DataGridBoundColumn)
ContentBinding	Hiermee haalt u de binding op of stelt u deze in op de tekst van de hyperlink.
DataGridOwner	Hiermee haalt u het DataGrid besturingselement op dat deze kolom bevat. (Overgenomen van DataGridColumn)
DefaultEditingElementStyle	De standaardwaarde van de EditingElementStyle eigenschap.
DefaultElementStyle	De standaardwaarde van de ElementStyle eigenschap.
DependencyObjectType	Hiermee haalt u het DependencyObjectType CLR-type van dit exemplaar op. (Overgenomen van DependencyObject)
Dispatcher	Hiermee wordt de Dispatcher aan dit DispatcherObject gekoppelde bestand. (Overgenomen van DispatcherObject)
DisplayIndex	Hiermee wordt de weergavepositie van de kolom ten opzichte van de andere kolommen in de DataGridkolom ophaalt of ingesteld. (Overgenomen van DataGridColumn)
DragIndicatorStyle	Hiermee wordt het stijlobject opgehaald of ingesteld dat moet worden toegepast op de kolomkop tijdens een sleepbewerking. (Overgenomen van DataGridColumn)
EditingElementStyle	Hiermee haalt u de stijl op die wordt gebruikt bij het weergeven van het element dat in de kolom wordt weergegeven voor een cel in de bewerkingsmodus. (Overgenomen van DataGridBoundColumn)
ElementStyle	Hiermee haalt u de stijl op die wordt gebruikt bij het weergeven van het element dat de kolom weergeeft voor een cel die zich niet in de bewerkingsmodus bevindt. (Overgenomen van DataGridBoundColumn)
Header	Hiermee haalt u de inhoud van de kolomkop op of stelt u deze in. (Overgenomen van DataGridColumn)
HeaderStringFormat	Hiermee haalt u het opmaakpatroon op dat moet worden toegepast op de inhoud van de kolomkop. (Overgenomen van DataGridColumn)
HeaderStyle	Hiermee haalt u de stijl op die wordt gebruikt bij het weergeven van de kolomkop. (Overgenomen van DataGridColumn)
HeaderTemplate	Hiermee haalt u de sjabloon op waarmee de visuele weergave van de kolomkop wordt gedefinieerd. (Overgenomen van DataGridColumn)
HeaderTemplateSelector	Hiermee wordt het object opgehaald of ingesteld waarmee wordt geselecteerd welke sjabloon moet worden gebruikt voor de kolomkop. (Overgenomen van DataGridColumn)
IsAutoGenerated	Hiermee wordt een waarde opgehaald die aangeeft of de kolom automatisch wordt gegenereerd. (Overgenomen van DataGridColumn)
IsFrozen	Hiermee wordt een waarde opgehaald die aangeeft of de kolom niet horizontaal kan schuiven. (Overgenomen van DataGridColumn)
IsReadOnly	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of cellen in de kolom kunnen worden bewerkt. (Overgenomen van DataGridColumn)
IsSealed	Hiermee wordt een waarde opgehaald die aangeeft of dit exemplaar momenteel is verzegeld (alleen-lezen). (Overgenomen van DependencyObject)
MaxWidth	Hiermee haalt u de maximale breedtebeperking van de kolom op of stelt u deze in. (Overgenomen van DataGridColumn)
MinWidth	Hiermee haalt u de minimale breedtebeperking van de kolom op of stelt u deze in. (Overgenomen van DataGridColumn)
SortDirection	Hiermee haalt u de sorteerrichting (oplopend of aflopend) van de kolom op of stelt u deze in. (Overgenomen van DataGridColumn)
SortMemberPath	Hiermee haalt u een eigenschapsnaam of een door perioden gescheiden hiërarchie van eigenschapsnamen op of stelt u deze in, waarmee het lid wordt aangegeven waarop moet worden gesorteerd. (Overgenomen van DataGridColumn)
TargetName	Hiermee haalt u de naam op van een doelvenster of doelframe voor de hyperlink.
Visibility	Hiermee haalt u de zichtbaarheid van de kolom op of stelt u deze in. (Overgenomen van DataGridColumn)
Width	Hiermee haalt u de kolombreedte of de automatische groottemodus op of stelt u deze in. (Overgenomen van DataGridColumn)

Methoden

Name	Description
CancelCellEdit(FrameworkElement, Object)	Zorgt ervoor dat de kolomcel wordt bewerkt om terug te keren naar de opgegeven waarde.
CancelCellEdit(FrameworkElement, Object)	Zorgt ervoor dat de cel wordt bewerkt om terug te keren naar de oorspronkelijke, niet-bewerkte waarde. (Overgenomen van DataGridColumn)
CheckAccess()	Bepaalt of de aanroepende thread toegang heeft tot dit DispatcherObject. (Overgenomen van DispatcherObject)
ClearValue(DependencyProperty)	Hiermee wist u de lokale waarde van een eigenschap. De eigenschap die moet worden gewist, wordt opgegeven door een DependencyProperty id. (Overgenomen van DependencyObject)
ClearValue(DependencyPropertyKey)	Hiermee wist u de lokale waarde van een alleen-lezen eigenschap. De eigenschap die moet worden gewist, wordt opgegeven door een DependencyPropertyKey. (Overgenomen van DependencyObject)
CoerceValue(DependencyProperty)	Hiermee wordt de waarde van de opgegeven afhankelijkheidseigenschap gecodeerd. Dit wordt bereikt door een CoerceValueCallback functie aan te roepen die is opgegeven in eigenschapsmetagegevens voor de afhankelijkheidseigenschap, zoals deze bestaat bij het aanroepen DependencyObject. (Overgenomen van DependencyObject)
CommitCellEdit(FrameworkElement)	Voert een vereiste validatie uit voordat de bewerkingsmodus wordt afgesloten.
CommitCellEdit(FrameworkElement)	Voert een vereiste validatie uit voordat de bewerkingsmodus voor cellen wordt afgesloten. (Overgenomen van DataGridColumn)
Equals(Object)	Bepaalt of een opgegeven DependencyObject gelijk is aan de huidige DependencyObject. (Overgenomen van DependencyObject)
GenerateEditingElement(DataGridCell, Object)	Hiermee haalt u een bewerkbaar TextBox element op dat is gebonden aan de eigenschapswaarde van ContentBinding de kolom.
GenerateElement(DataGridCell, Object)	Hiermee wordt een alleen-lezenelement Hyperlink opgehaald dat is gebonden aan de eigenschapswaarde van ContentBinding de kolom.
GetCellContent(DataGridRow)	Haalt de Content eigenschapswaarde voor de cel op het snijpunt van deze kolom en de opgegeven rij op. (Overgenomen van DataGridColumn)
GetCellContent(Object)	Hiermee haalt u de Content eigenschapswaarde op voor de cel op het snijpunt van deze kolom en de rij die het opgegeven gegevensitem vertegenwoordigt. (Overgenomen van DataGridColumn)
GetHashCode()	Hiermee haalt u een hashcode op.DependencyObject (Overgenomen van DependencyObject)
GetLocalValueEnumerator()	Hiermee maakt u een gespecialiseerde enumerator om te bepalen welke afhankelijkheidseigenschappen lokaal waarden hebben ingesteld.DependencyObject (Overgenomen van DependencyObject)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
GetValue(DependencyProperty)	Retourneert de huidige effectieve waarde van een afhankelijkheidseigenschap op dit exemplaar van een DependencyObject. (Overgenomen van DependencyObject)
InvalidateProperty(DependencyProperty)	Evalueert de effectieve waarde voor de opgegeven afhankelijkheidseigenschap opnieuw. (Overgenomen van DependencyObject)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
NotifyPropertyChanged(String)	Hiermee wordt aangegeven DataGrid dat deze kolom bevat dat een kolomeigenschap is gewijzigd. (Overgenomen van DataGridColumn)
OnBindingChanged(BindingBase, BindingBase)	Hiermee wordt opgegeven DataGrid wanneer de waarde van de Binding eigenschap wordt gewijzigd. (Overgenomen van DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)	Bepaalt de waarde van de IsReadOnly eigenschap op basis van eigenschapsregels uit het gegevensraster die deze kolom bevat. (Overgenomen van DataGridBoundColumn)
OnContentBindingChanged(BindingBase, BindingBase)	Hiermee wordt opgegeven DataGrid wanneer de ContentBinding eigenschap wordt gewijzigd.
OnCopyingCellClipboardContent(Object)	Hiermee wordt de CopyingCellClipboardContent gebeurtenis gegenereerd. (Overgenomen van DataGridColumn)
OnPastingCellClipboardContent(Object, Object)	Hiermee wordt de PastingCellClipboardContent gebeurtenis gegenereerd. (Overgenomen van DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Aangeroepen wanneer de effectieve waarde van een afhankelijkheidseigenschap op deze DependencyObject eigenschap is bijgewerkt. De specifieke afhankelijkheidseigenschap die is gewijzigd, wordt gerapporteerd in de gebeurtenisgegevens. (Overgenomen van DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)	Aangeroepen wanneer een cel in de kolom in de bewerkingsmodus wordt geactiveerd.
ReadLocalValue(DependencyProperty)	Retourneert de lokale waarde van een afhankelijkheidseigenschap, als deze bestaat. (Overgenomen van DependencyObject)
RefreshCellContent(FrameworkElement, String)	Hiermee vernieuwt u de inhoud van een cel in de kolom als reactie op een wijziging in de kolomeigenschapswaarde.
SetCurrentValue(DependencyProperty, Object)	Hiermee stelt u de waarde van een afhankelijkheidseigenschap in zonder de waardebron te wijzigen. (Overgenomen van DependencyObject)
SetValue(DependencyProperty, Object)	Hiermee stelt u de lokale waarde van een afhankelijkheidseigenschap in, die is opgegeven door de id van de afhankelijkheidseigenschap. (Overgenomen van DependencyObject)
SetValue(DependencyPropertyKey, Object)	Hiermee stelt u de lokale waarde van een alleen-lezen afhankelijkheidseigenschap in, die is opgegeven door de DependencyPropertyKey id van de afhankelijkheidseigenschap. (Overgenomen van DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Retourneert een waarde die aangeeft of serialisatieprocessen de waarde voor de opgegeven afhankelijkheidseigenschap moeten serialiseren. (Overgenomen van DependencyObject)
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)
VerifyAccess()	Hiermee wordt afgedwongen dat de aanroepende thread toegang heeft tot dit DispatcherObject. (Overgenomen van DispatcherObject)

gebeurtenis

Name	Description
CopyingCellClipboardContent	Vindt plaats nadat de inhoud van het klembord van de cel is voorbereid. (Overgenomen van DataGridColumn)
PastingCellClipboardContent	Vindt plaats voordat de inhoud van het klembord naar de cel wordt verplaatst. (Overgenomen van DataGridColumn)

Van toepassing op

Zie ook

Hyperlink

Feedback

Is deze pagina nuttig?