DataGridHyperlinkColumn Classe

Definição

Representa uma coluna DataGrid que hospeda elementos Uri em suas células.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
Herança

Exemplos

O exemplo a seguir mostra DataGridHyperlinkColumn um que define Uri o com Binding a propriedade e o texto do hiperlink ContentBinding com a propriedade.The following example shows a DataGridHyperlinkColumn that sets the Uri with the Binding property and the hyperlink text with the ContentBinding property. O Hyperlink.Click evento é manipulado automaticamente NavigationWindow porque DataGridé o pai do.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

Comentários

Use DataGridHyperlinkColumn para exibir dados que contenham um Uri, como um endereço http ou endereço de email.Use DataGridHyperlinkColumn to display data that contains a Uri, such as an HTTP address or email address. A ilustração a seguir mostra um exemplo de DataGridHyperlinkColumnum.The following illustration shows an example of a DataGridHyperlinkColumn.

![DataGridHyperlinkColumn com endereços de email] (~/add/media/wpf-hyperlinkcolumn.png "DataGridHyperlinkColumn com endereços de email")DataGridHyperlinkColumn with email addresses

Observação

Hyperlinka navegação só poderá ocorrer se o pai direto ou indireto de Hyperlink um for um host de navegação.Hyperlink navigation can only occur if either the direct or indirect parent of a Hyperlink is a navigation host. Exemplos de hosts de NavigationWindownavegação Frameincluem, ou qualquer navegador que pode XBAPsXBAPshospedar, como Microsoft Internet Explorer 6Microsoft Internet Explorer 6 ou posterior e o Firefox 2,0 ou posterior.Examples of navigation hosts include NavigationWindow, Frame, or any browser that can host XBAPsXBAPs, such as Microsoft Internet Explorer 6Microsoft Internet Explorer 6 or later and Firefox 2.0 or later. Para obter mais informações, consulte o tópico "hosts de navegação" em visão geral de navegação.For more information, see the "Navigation Hosts" topic in Navigation Overview.

Para preencher a coluna, associe a coluna aos Uri dados usando a Binding propriedade.To populate the column, bind the column to the Uri data by using the Binding property. Para exibir o texto do hiperlink diferente da cadeia de caracteres do URI, associe o valor de ContentBinding texto à propriedade.To display hyperlink text that is different than the URI string, bind the text value to the ContentBinding property. A Binding propriedade é aplicada Hyperlink ao elemento ou TextBox criado na coluna.The Binding property is applied to the Hyperlink or TextBox element created in the column. O DataContext para o elemento em cada célula é o item de dados para a linha em que a célula está.The DataContext for the element in each cell is the data item for the row the cell is in. Portanto, para configurar a associação, você só precisa definir o Binding.Path.Therefore, to set up the binding you only have to set the Binding.Path. Opcionalmente, você pode especificar um Binding.Converter se quiser converter os dados.Optionally, you can specify a Binding.Converter if you want to convert the data. Para obter mais informações sobre vinculação de dados, consulte vinculação de dados (WPF).For more information about data binding, see Data Binding (WPF).

Observação

DataGridHyperlinkColumnCria um Hyperlink elemento no modo de não edição e um TextBox elemento no modo de edição.DataGridHyperlinkColumn creates a Hyperlink element in the non-editing mode and a TextBox element in the editing mode.

Se você quiser exibir outros tipos de dados, DataGrid o fornecerá os seguintes tipos de coluna:If you want to display other types of data, DataGrid provides the following column types:

Tipo de colunaColumn Type Exibição de dadosData Display
DataGridCheckBoxColumn Use para exibir dados boolianos.Use to display Boolean data.
DataGridComboBoxColumn Use para exibir dados de enumeração.Use to display enumeration data.
DataGridTextColumn Use para exibir texto.Use to display text.

Se você quiser usar outros controles em seu DataGrid, poderá criar seus próprios tipos de coluna usando DataGridTemplateColumno.If you want to use other controls in your DataGrid, you can create your own column types by using DataGridTemplateColumn.

Construtores

DataGridHyperlinkColumn()

Inicializa uma nova instância da classe DataGridHyperlinkColumn.Initializes a new instance of the DataGridHyperlinkColumn class.

Campos

TargetNameProperty

Identifica a propriedade de dependência TargetName.Identifies the TargetName dependency property.

Propriedades

ActualWidth

Obtém a largura atual da coluna, em unidades independentes de dispositivo (1/96 polegada por unidade)device-independent units (1/96th inch per unit).Gets the current width of the column, in unidades independentes de dispositivo (1/96 polegada por unidade)device-independent units (1/96th inch per unit).

(Herdado de DataGridColumn)
Binding

Obtém ou define a associação que associa a coluna com a propriedade na fonte de dados.Gets or sets the binding that associates the column with a property in the data source.

(Herdado de DataGridBoundColumn)
CanUserReorder

Obtém ou define um valor que indica se o usuário pode alterar a posição de exibição da coluna arrastando o seu cabeçalho.Gets or sets a value that indicates whether the user can change the column display position by dragging the column header.

(Herdado de DataGridColumn)
CanUserResize

Obtém ou define um valor que indica se o usuário pode ajustar a largura da coluna usando o mouse.Gets or sets a value that indicates whether the user can adjust the column width by using the mouse.

(Herdado de DataGridColumn)
CanUserSort

Obtém ou define um valor que indica se o usuário pode classificar a coluna clicando no seu cabeçalho.Gets or sets a value that indicates whether the user can sort the column by clicking the column header.

(Herdado de DataGridColumn)
CellStyle

Obtém ou define o estilo usado para renderizar as células da coluna.Gets or sets the style that is used to render cells in the column.

(Herdado de DataGridColumn)
ClipboardContentBinding

Obtém ou define o objeto de associação a ser usado ao obter ou definir o conteúdo da célula para a área de transferência.Gets or sets the binding object to use when getting or setting cell content for the clipboard.

(Herdado de DataGridBoundColumn)
ContentBinding

Obtém ou define a associação para o texto do hiperlink.Gets or sets the binding to the text of the hyperlink.

DataGridOwner

Obtém o controle DataGrid que contém esta coluna.Gets the DataGrid control that contains this column.

(Herdado de DataGridColumn)
DefaultEditingElementStyle

O valor padrão da propriedade EditingElementStyle.The default value of the EditingElementStyle property.

DefaultElementStyle

O valor padrão da propriedade ElementStyle.The default value of the ElementStyle property.

DependencyObjectType

Obtém o DependencyObjectType que encapsula o tipo CLRCLR dessa instância.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Herdado de DependencyObject)
Dispatcher

Obtém o Dispatcher ao qual este DispatcherObject está associado.Gets the Dispatcher this DispatcherObject is associated with.

(Herdado de DispatcherObject)
DisplayIndex

Obtém ou define a posição de exibição da coluna em relação às outras colunas do DataGrid.Gets or sets the display position of the column relative to the other columns in the DataGrid.

(Herdado de DataGridColumn)
DragIndicatorStyle

Obtém ou define o objeto de estilo para aplicar ao cabeçalho de coluna durante uma operação de arrastar.Gets or sets the style object to apply to the column header during a drag operation.

(Herdado de DataGridColumn)
EditingElementStyle

Obtém ou define o estilo usado ao renderizar o elemento que a coluna exibe para uma célula no modo de edição.Gets or sets the style that is used when rendering the element that the column displays for a cell in editing mode.

(Herdado de DataGridBoundColumn)
ElementStyle

Obtém ou define o estilo usado ao renderizar o elemento que a coluna exibe para uma célula que não está no modo de edição.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.

(Herdado de DataGridBoundColumn)
Header

Obtém ou define o conteúdo do cabeçalho da coluna.Gets or sets the content of the column header.

(Herdado de DataGridColumn)
HeaderStringFormat

Obtém ou define o padrão de formato a ser aplicado ao conteúdo do cabeçalho de coluna.Gets or sets the format pattern to apply to the content of the column header.

(Herdado de DataGridColumn)
HeaderStyle

Obtém ou define o estilo usado ao renderizar o cabeçalho de coluna.Gets or sets the style that is used when rendering the column header.

(Herdado de DataGridColumn)
HeaderTemplate

Obtém ou define o modelo que define a representação visual do cabeçalho de coluna.Gets or sets the template that defines the visual representation of the column header.

(Herdado de DataGridColumn)
HeaderTemplateSelector

Obtém ou define o objeto que seleciona qual modelo usar para o cabeçalho de coluna.Gets or sets the object that selects which template to use for the column header.

(Herdado de DataGridColumn)
IsAutoGenerated

Obtém um valor que indica se a coluna é somente autogerenciada.Gets a value that indicates whether the column is auto-generated.

(Herdado de DataGridColumn)
IsFrozen

Obtém um valor que indica se a coluna está impedida de rolar horizontalmente.Gets a value that indicates whether the column is prevented from scrolling horizontally.

(Herdado de DataGridColumn)
IsReadOnly

Obtém ou define um valor que indica se as células na coluna podem ser editadas.Gets or sets a value that indicates whether cells in the column can be edited.

(Herdado de DataGridColumn)
IsSealed

Obtém um valor que indica se essa instância está validada no momento (somente leitura).Gets a value that indicates whether this instance is currently sealed (read-only).

(Herdado de DependencyObject)
MaxWidth

Obtém ou define a restrição de largura máxima da coluna.Gets or sets the maximum width constraint of the column.

(Herdado de DataGridColumn)
MinWidth

Obtém ou define a restrição de largura mínima da coluna.Gets or sets the minimum width constraint of the column.

(Herdado de DataGridColumn)
SortDirection

Obtém ou define a direção da classificação (crescente ou decrescente) da coluna.Gets or sets the sort direction (ascending or descending) of the column.

(Herdado de DataGridColumn)
SortMemberPath

Obtém ou define um nome de propriedade, ou uma hierarquia de nomes de propriedade baseada na delimitação por ponto, que indica o membro pelo qual classificar.Gets or sets a property name, or a period-delimited hierarchy of property names, that indicates the member to sort by.

(Herdado de DataGridColumn)
TargetName

Obtém ou define o nome de um quadro ou janela de destino do hiperlink.Gets or sets the name of a target window or frame for the hyperlink.

Visibility

Obtém ou define a visibilidade da coluna.Gets or sets the visibility of the column.

(Herdado de DataGridColumn)
Width

Obtém ou define a largura da coluna ou o modo de dimensionamento automático.Gets or sets the column width or automatic sizing mode.

(Herdado de DataGridColumn)

Métodos

CancelCellEdit(FrameworkElement, Object)

Faz com que a célula da coluna que está sendo editada reverta para o valor especificado.Causes the column cell being edited to revert to the specified value.

CheckAccess()

Determina se o thread de chamada tem acesso a este DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Herdado de DispatcherObject)
ClearValue(DependencyProperty)

Limpa o valor local de uma propriedade.Clears the local value of a property. A propriedade a ser limpa é especificada por um identificador DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)

Limpa o valor local de uma propriedade somente leitura.Clears the local value of a read-only property. A propriedade a ser limpa é especificada por um DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Herdado de DependencyObject)
CoerceValue(DependencyProperty)

Converte o valor da propriedade de dependência especificada.Coerces the value of the specified dependency property. Isso é feito invocando qualquer função CoerceValueCallback especificada nos metadados de propriedade para a propriedade de dependência, visto que ela existe na chamada a DependencyObject.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Herdado de DependencyObject)
CommitCellEdit(FrameworkElement)

Realiza a validação necessária antes de sair do modo de edição.Performs any required validation before exiting edit mode.

Equals(Object)

Determina se um DependencyObject fornecido é equivalente ao DependencyObject atual.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Herdado de DependencyObject)
GenerateEditingElement(DataGridCell, Object)

Obtém um elemento TextBox editável que está vinculado ao valor da propriedade ContentBinding da coluna.Gets an editable TextBox element that is bound to the column's ContentBinding property value.

GenerateElement(DataGridCell, Object)

Obtém um elemento Hyperlink somente leitura associado ao valor da propriedade ContentBinding da coluna.Gets a read-only Hyperlink element that is bound to the column's ContentBinding property value.

GetCellContent(DataGridRow)

Recupera o valor da propriedade Content da célula na interseção dessa coluna e da linha especificada.Retrieves the Content property value for the cell at the intersection of this column and the specified row.

(Herdado de DataGridColumn)
GetCellContent(Object)

Obtém o valor da propriedade Content da célula na interseção dessa coluna e da linha que representa o item de dados especificado.Gets the Content property value for the cell at the intersection of this column and the row that represents the specified data item.

(Herdado de DataGridColumn)
GetHashCode()

Obtém o código hash para esse DependencyObject.Gets a hash code for this DependencyObject.

(Herdado de DependencyObject)
GetLocalValueEnumerator()

Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente nessa DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Herdado de DependencyObject)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetValue(DependencyProperty)

Retorna o valor efetivo atual de uma propriedade de dependência nessa instância de um DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Herdado de DependencyObject)
InvalidateProperty(DependencyProperty)

Reavalia o valor efetivo para a propriedade de dependência especificada.Re-evaluates the effective value for the specified dependency property.

(Herdado de DependencyObject)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
NotifyPropertyChanged(String)

Notifica o DataGrid que contém essa coluna de que uma propriedade da coluna foi alterada.Notifies the DataGrid that contains this column that a column property has changed.

(Herdado de DataGridColumn)
OnBindingChanged(BindingBase, BindingBase)

Notifica o DataGrid quando o valor da propriedade Binding é alterado.Notifies the DataGrid when the value of the Binding property changes.

(Herdado de DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)

Determina o valor da propriedade IsReadOnly com base nas regras de propriedade da grade de dados que contém essa coluna.Determines the value of the IsReadOnly property based on property rules from the data grid that contains this column.

(Herdado de DataGridBoundColumn)
OnContentBindingChanged(BindingBase, BindingBase)

Notifica o DataGrid quando a propriedade ContentBinding mudar.Notifies the DataGrid when the ContentBinding property changes.

OnCopyingCellClipboardContent(Object)

Aciona o evento CopyingCellClipboardContent.Raises the CopyingCellClipboardContent event.

(Herdado de DataGridColumn)
OnPastingCellClipboardContent(Object, Object)

Aciona o evento PastingCellClipboardContent.Raises the PastingCellClipboardContent event.

(Herdado de DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Invocado sempre que o valor efetivo de qualquer propriedade de dependência nesse DependencyObject for atualizada.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. A propriedade de dependência específica que mudou é relatada os dados do evento.The specific dependency property that changed is reported in the event data.

(Herdado de DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)

Chamado quando uma célula na coluna entra em modo de edição.Called when a cell in the column enters editing mode.

ReadLocalValue(DependencyProperty)

Retorna o valor local de uma propriedade de dependência, local, se houver.Returns the local value of a dependency property, if it exists.

(Herdado de DependencyObject)
RefreshCellContent(FrameworkElement, String)

Atualiza o conteúdo de uma célula na coluna em resposta a uma alteração de valor da propriedade de coluna.Refreshes the contents of a cell in the column in response to a column property value change.

SetCurrentValue(DependencyProperty, Object)

Define o valor da propriedade de dependência sem alterar a origem do valor.Sets the value of a dependency property without changing its value source.

(Herdado de DependencyObject)
SetValue(DependencyProperty, Object)

Define o valor local de uma propriedade de dependência, especificada pelo identificador da propriedade de dependência.Sets the local value of a dependency property, specified by its dependency property identifier.

(Herdado de DependencyObject)
SetValue(DependencyPropertyKey, Object)

Define o valor de uma propriedade de dependência somente leitura, especificada pelo identificador DependencyPropertyKey da propriedade de dependência.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Herdado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Retorna um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Herdado de DependencyObject)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
VerifyAccess()

Impõe que o thread de chamada tenha acesso a este DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Herdado de DispatcherObject)

Eventos

CopyingCellClipboardContent

Ocorre depois que o conteúdo da Área de Transferência é preparado.Occurs after the cell clipboard content is prepared.

(Herdado de DataGridColumn)
PastingCellClipboardContent

Ocorre antes de o conteúdo da área de transferência ser movido para a célula.Occurs before the clipboard content is moved to the cell.

(Herdado de DataGridColumn)

Aplica-se a

Veja também