Binding Sınıf

Başvuru

Tanım

Ad Alanı:: System.Windows.Data

Bütünleştirilmiş Kod:: PresentationFramework.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Bağlama hedef nesnelerinin (genellikle, WPF öğeleri) ve herhangi bir veri kaynağının (örneğin, veritabanı, XML dosyası veya veri içeren herhangi bir nesne) özelliklerini bağlayan bağlama tanımına üst düzey erişim sağlar.

public ref class Binding : System::Windows::Data::BindingBase

public class Binding : System.Windows.Data.BindingBase

type Binding = class
    inherit BindingBase

Public Class Binding
Inherits BindingBase

Devralma: Object

MarkupExtension

BindingBase
Binding

Açıklamalar

Windows Presentation Foundation (WPF) veri bağlaması, uygulamaların veri sunması ve verilerle etkileşim kurması için basit ve tutarlı bir yol sağlar. Veri bağlama, iki farklı nesnenin özelliklerinin değerlerini eşitlemenizi sağlar.

Bağlama oluşturmak için sınıfını Binding veya devralan BindingBasediğer sınıflardan birini kullanın. Hangi nesneyi bağladığınıza ve veri kaynağınızın yapısına bakılmaksızın, her bağlama aşağıdaki şekilde gösterilen modeli izler.

Temel veri bağlama diyagramı

Şekilde aşağıdaki temel WPF veri bağlama kavramları gösterilmektedir.

Her bağlama genellikle şu dört bileşene sahiptir: bağlama hedef nesnesi, hedef özellik, bağlama kaynağı ve Path kullanılacak bağlama kaynağındaki değere. Örneğin, öğesinin TextBox içeriğini bir Employee nesnesinin Name özelliğine bağlamak istiyorsanız, hedef nesneniz TextBox, hedef özelliği Text özelliği, kullanılacak değer Ad ve kaynak nesne de Employee nesnesidir.
Hedef özellik bir bağımlılık özelliği olmalıdır. Bu aynı zamanda bir alanı bağlayamayacağınız anlamına gelir. Nesnelerin özelliklerinin UIElement çoğu bağımlılık özellikleridir ve salt okunur olanlar dışında çoğu bağımlılık özelliği varsayılan olarak veri bağlamayı destekler. (Yalnızca DependencyObject türler bağımlılık özelliklerini tanımlayabilir ve tüm UIElement nesneler öğesinden DependencyObjecttüretilebilir.)
Şekilde belirtilmemiş olsa da, bağlama kaynak nesnesinin özel bir CLR nesnesi olmakla sınırlı olmadığı belirtilmelidir. WPF veri bağlama, CLR nesneleri ve XML biçimindeki verileri destekler. Bazı örnekler sağlamak için bağlama kaynağınız bir , herhangi bir UIElementliste nesnesi, ADO.NET verileri veya Web Hizmetleri ile ilişkilendirilmiş bir CLR nesnesi ya da XML verilerinizi içeren bir XmlNode olabilir.

Veri akışının Mode yönünü belirtmek için özelliğini kullanın. Kaynak değişikliklerini tek yönlü veya iki yönlü bağlamalarda algılamak için, kaynağın gibi INotifyPropertyChangeduygun bir özellik değişiklik bildirim mekanizması uygulaması gerekir. Örnek için bkz . Nasıl yapılır: Özellik Değişikliği Bildirimi Uygulama. UpdateSourceTrigger özelliği kaynak güncelleştirmelerinin zamanlamasını belirtir. Daha fazla bilgi için Bkz. Veri Bağlamaya Genel Bakış bölümündeki "Temel Veri Bağlama Kavramları".

XAML Öznitelik Kullanımı

<object property="{Binding  declaration}"/>

XAML Değerleri

Bildirim
Virgülle (,) ayrılmış sıfır veya daha fazla öznitelik atama yan tümcesi. Daha fazla bilgi için bkz . Bağlama İşaretleme Uzantısı veya Bağlama Bildirimlerine Genel Bakış.

Oluşturucular

Binding()	Binding sınıfının yeni bir örneğini başlatır.
Binding(String)	başlangıç yolu ile sınıfının yeni bir örneğini Binding başlatır.

Alanlar

DoNothing	Bağlama altyapısına herhangi bir eylem gerçekleştirmemelerini bildirmek için döndürülen bir değer olarak kullanılır.
IndexerName	PropertyName PropertyChangedEventArgs dizin oluşturucu özelliğinin değiştiğini belirtmek için olarak kullanılır.
SourceUpdatedEvent	Ekli SourceUpdated olayı tanımlar.
TargetUpdatedEvent	Ekli TargetUpdated olayı tanımlar.
XmlNamespaceManagerProperty	XmlNamespaceManager Ekli özelliği tanımlar.

Özellikler

AsyncState	Zaman uyumsuz veri dağıtıcısına geçirilen opak verileri alır veya ayarlar.
BindingGroupName	Bu bağlamanın ait olduğu öğesinin BindingGroup adını alır veya ayarlar. (Devralındığı yer: BindingBase)
BindsDirectlyToSource	Veri öğesine veya nesneye göre değerlendirme Path yapılıp yapılmayacağını belirten bir değer alır veya DataSourceProvider ayarlar.
Converter	Kullanılacak dönüştürücüsü alır veya ayarlar.
ConverterCulture	Dönüştürücüsü değerlendirilecek kültürü alır veya ayarlar.
ConverterParameter	parametresini öğesine geçirmek Converteriçin alır veya ayarlar.
Delay	Hedefteki değer değiştikten sonra bağlama kaynağını güncelleştirmeden önce beklenmesi için milisaniye cinsinden süreyi alır veya ayarlar. (Devralındığı yer: BindingBase)
ElementName	Bağlama kaynak nesnesi olarak kullanılacak öğenin adını alır veya ayarlar.
FallbackValue	Bağlama bir değer döndüremediğinde kullanılacak değeri alır veya ayarlar. (Devralındığı yer: BindingBase)
IsAsync	değerlerinin zaman uyumsuz olarak alınıp alınmayacağını ve ayarlanıp ayarlanmayacağını Binding belirten bir değeri alır veya ayarlar.
Mode	Bağlamadaki veri akışının yönünü gösteren bir değer alır veya ayarlar.
NotifyOnSourceUpdated	Bağlama hedefinden bağlama kaynağına bir değer aktarıldığında olayı tetikleyip tetiklemeyeceğini SourceUpdated belirten bir değer alır veya ayarlar.
NotifyOnTargetUpdated	Bağlama kaynağından bağlama hedefine bir değer aktarıldığında olayı tetikleyip tetiklemeyeceğini TargetUpdated belirten bir değer alır veya ayarlar.
NotifyOnValidationError	bağlı nesnede ekli olayın yükseltilip yükseltmeyeceğini Error belirten bir değer alır veya ayarlar.
Path	Bağlama kaynağı özelliğinin yolunu alır veya ayarlar.
RelativeSource	Bağlama hedefinin konumuna göre konumunu belirterek bağlama kaynağını alır veya ayarlar.
Source	Bağlama kaynağı olarak kullanılacak nesneyi alır veya ayarlar.
StringFormat	Bağlı değeri bir dize olarak görüntülerse bağlamanın nasıl biçimlendirildiğini belirten bir dize alır veya ayarlar. (Devralındığı yer: BindingBase)
TargetNullValue	Kaynağın `null`değeri olduğunda hedefte kullanılan değeri alır veya ayarlar. (Devralındığı yer: BindingBase)
UpdateSourceExceptionFilter	Bağlama altyapısının bağlama kaynak değerinin güncelleştirmesi sırasında karşılaştığı özel durumları işlemek için özel mantık sağlamak için kullanabileceğiniz bir işleyici alır veya ayarlar. Bu yalnızca bağlamanızla ilişkilendirdiğiniz durumlarda ExceptionValidationRule geçerlidir.
UpdateSourceTrigger	Bağlama kaynağı güncelleştirmelerinin zamanlamasını belirleyen bir değer alır veya ayarlar.
ValidatesOnDataErrors	öğesinin dahil DataErrorValidationRuleedilip edilmeyeceğini belirten bir değer alır veya ayarlar.
ValidatesOnExceptions	öğesinin dahil ExceptionValidationRuleedilip edilmeyeceğini belirten bir değer alır veya ayarlar.
ValidatesOnNotifyDataErrors	öğesinin dahil NotifyDataErrorValidationRuleedilip edilmeyeceğini belirten bir değer alır veya ayarlar.
ValidationRules	Kullanıcı girişinin geçerliliğini denetleen bir kural koleksiyonu alır.
XPath	Kullanılacak XML bağlama kaynağındaki değeri döndüren bir `XPath` sorguyu alır veya ayarlar.

İliştirilmiş Özellikler

XmlNamespaceManager

XML bağlamalarında ad alanı algılayan XPath sorgular gerçekleştirmek için kullanılan öğesini alır veya ayarlarXmlNamespaceManager.

Yöntemler

AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Ekli olay için SourceUpdated bir işleyici ekler.
AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Ekli olay için TargetUpdated bir işleyici ekler.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
GetXmlNamespaceManager(DependencyObject)	Belirtilen nesneye bağlı bağlama tarafından kullanılan bir XML ad alanı yöneticisi nesnesi döndürür.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ProvideValue(IServiceProvider)	Bu bağlama ve uzantının uygulandığı özellikte ayarlanması gereken bir nesne döndürür. (Devralındığı yer: BindingBase)
RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Ekli olay için bir işleyici kaldırır SourceUpdated .
RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Ekli olay için bir işleyici kaldırır TargetUpdated .
SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager)	Sağlanan öğeye eklenmiş bağlama tarafından kullanılan bir ad alanı yöneticisi nesnesi ayarlar.
ShouldSerializeFallbackValue()	Serileştirme işlemlerinin bu sınıfın örneklerinde özelliğin etkin değerini serileştirmesi FallbackValue gerekip gerekmediğini belirten bir değer döndürür. (Devralındığı yer: BindingBase)
ShouldSerializePath()	Özelliğin Path kalıcı olup olmayacağını gösterir.
ShouldSerializeSource()	Özelliğin Source kalıcı olup olmayacağını gösterir.
ShouldSerializeTargetNullValue()	Özelliğin seri hale getirilip getirilmeyeceğini TargetNullValue belirten bir değer döndürür. (Devralındığı yer: BindingBase)
ShouldSerializeValidationRules()	Özelliğin ValidationRules kalıcı olup olmayacağını gösterir.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

İliştirilmiş Olaylar

SourceUpdated	Bir değer bağlama hedefinden bağlama kaynağına aktarıldığında, ancak yalnızca değerine ayarlanmış `true`bağlamalar NotifyOnSourceUpdated için gerçekleşir.
TargetUpdated	Bir değer bağlama kaynağından bağlama hedefine aktarıldığında gerçekleşir, ancak yalnızca değerine ayarlanmış `true`bağlamalar NotifyOnTargetUpdated için gerçekleşir.

Şunlara uygulanır