Binding Sınıf

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ğlama, uygulamaların veri sunup 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 içeriğini bir TextBox Employee nesnesinin Name özelliğine bağlamak istiyorsanız, hedef nesneniz TextBoxözelliğidir, hedef özellik özelliğidir Text , kullanılacak değer Name ve kaynak nesne de Employee nesnesidir.
Hedef özellik bir bağımlılık özelliği olmalıdır. Bu, bir alanı bağlayamayacağınız anlamına da 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 ve türetilen DependencyObjecttüm UIElement nesneleri tanımlayabilir.)
Ş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 veya 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şiklikleri tek yönlü veya iki yönlü bağlamalarda algılamak için, kaynağın gibi INotifyPropertyChangeduygun bir özellik değişikliği bildirim mekanizması uygulaması gerekir. Bir örnek için bkz . Nasıl yapılır: Özellik Değişikliği BildirimiNi Uygulama. UpdateSourceTrigger özelliği, kaynak güncelleştirmelerin zamanlamasını belirtir. Daha fazla bilgi için Bkz. Veri Bağlamaya Genel Bakış'taki "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

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

Alanlar

Name	Description
DoNothing	Bağlama altyapısına herhangi bir eylem gerçekleştirmemesi için yönerge vermek için döndürülen bir değer olarak kullanılır.
IndexerName	PropertyName PropertyChangedEventArgs bir 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	Ekli özelliği tanımlar XmlNamespaceManager .

Özellikler

Name	Description
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ğerlendirilip değerlendirilmeyeceğini Path belirten bir değer alır veya DataSourceProvider ayarlar.
Converter	Dönüştürücüsü kullanacak şekilde alır veya ayarlar.
ConverterCulture	Dönüştürücüsü değerlendirilecek kültürü alır veya ayarlar.
ConverterParameter	parametresini alır veya parametresine Convertergeçirecek şekilde 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ğer 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 kaynağını, bağlama hedefinin konumuna göre konumunu belirterek alır veya ayarlar.
Source	Bağlama kaynağı olarak kullanılacak nesneyi alır veya ayarlar.
StringFormat	İlişkili değeri 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 kaynak 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

Name	Description
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

Name	Description
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()	Geçerli örneğin Type 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 Objectbasit 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 seri hale getirmesi FallbackValue gerekip gerekmediğini gösteren 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 gösteren 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 bir dize döndürür. (Devralındığı yer: Object)

İliştirilmiş Olaylar

Name	Description
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

Ayrıca bkz.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?