Özel verileri SharePoint Araçlar uzantıları ile ilişkilendirme

Makale
02/26/2013

SharePoint Araçlar uzantılarında belirli nesnelere özel veri ekleyebilirsiniz.Daha sonra başka bir kodu dahili numaranız erişmek istediğiniz dahili numaranız bir bölümünde veri olduğunda yararlıdır.Saklamak ve verilere erişmek için özel bir şekilde uygulamak yerine, veri içeren bir nesne kendi uzantısı ilişkilendirmek ve verileri aynı nesneden daha sonra almak.

Belirli bir madde Visual Studio ile ilgili verileri korumak istediğinizde, özel veri nesnelerine ekleme de yararlıdır.SharePoint Araçlar uzantıları yalnızca Visual Studio'da, böylece dahili numaranız ile birçok farklı öğeyi çalışabilir bir kez yüklendiğinde (projeler gibi öğeler, proje veya Server Explorer düğümleri) herhangi bir zamanda.Yalnızca belirli bir madde için uygun olan özel veri varsa, bu öğeyi temsil eden nesne verileri ekleyebilirsiniz.

SharePoint Araçlar uzantıları içindeki nesnelere özel veri eklediğinizde, veri geçerli değil.Verileri yalnızca nesnenin ömrü sırasında kullanılabilir.Nesneyi çöp toplama işlemi tarafından iadesi sonra veriler kaybolur.

SharePoint proje sistem uzantılarında bir uzantı kaldırılır sonra devam ederse, string veri kaydedebilirsiniz.Daha fazla bilgi için bkz. SharePoint proje sistem uzantılarında verilerini kaydetme.

Özel veri içeren nesneleri

Özel veri uygulayan SharePoint Araçlar nesne modelindeki herhangi bir nesne ekleyebilirsiniz IAnnotatedObject arabirimi.Yalnızca bir özellik, bu arabirimi tanımlayan Annotations, özel veri nesnelerinin bir koleksiyonu olup.Aşağıdaki türlerden uygulamak IAnnotatedObject:

Ekleme ve özel veri alma

SharePoint Araçlar uzantısı'ndaki bir nesneye özel veri eklemek için Al Annotations veri eklemek ve sonra kullanmak istediğiniz nesnenin özelliği IAnnotationDictionary.Add() nesnesine veri ekleme yöntemi.

SharePoint Araçlar uzantısındaki bir nesneden özel veri almak için get Annotations nesnesini ve sonra bir aşağıdaki yöntemlerden birini kullanın:

IAnnotationDictionary.TryGetValue().Bu yöntem döndürür true veri nesnesi varsa, ya da false yoksa onu.Değer türü mü yoksa başvuru türü örnekleri almak için bu yöntemi kullanabilirsiniz.
IAnnotationDictionary.GetValue().Bu yöntem verileri döndürür bulunup, nesne veya null yoksa onu.Yalnızca başvuru türleri örnekleri almak için bu yöntemi kullanabilirsiniz.

Aşağıdaki kod örneği, belirli bir veri nesnesi zaten proje öğe ile ilişkili olup olmadığını belirler.Veri nesnesi zaten proje maddeyle ilişkili değil sonra kod nesnesine ekler Annotations proje öğesi özelliği.Bu bağlamda daha büyük bir örnek görmek için bkz: Nasıl yapılır: bir özel SharePoint proje öğe türü için bir özellik ekleme.

Private Sub ProjectItemPropertiesRequested(ByVal Sender As Object,
    ByVal e As SharePointProjectItemPropertiesRequestedEventArgs)
    Dim propertyObject As CustomProperties = Nothing

    ' If the properties object already exists, get it from the project item's annotations.
    If False = e.ProjectItem.Annotations.TryGetValue(propertyObject) Then
        ' Otherwise, create a new properties object and add it to the annotations.
        propertyObject = New CustomProperties(e.ProjectItem)
        e.ProjectItem.Annotations.Add(propertyObject)
    End If
    e.PropertySources.Add(propertyObject)
End Sub

void projectItemTypeDefinition_ProjectItemPropertiesRequested(object sender, 
    SharePointProjectItemPropertiesRequestedEventArgs e)
{
    CustomProperties property;

    // If the properties object already exists, get it from the project item's annotations.
    if (!e.ProjectItem.Annotations.TryGetValue(out property))
    {
        // Otherwise, create a new properties object and add it to the annotations.
        property = new CustomProperties(e.ProjectItem);
        e.ProjectItem.Annotations.Add(property);
    }

    e.PropertySources.Add(property);
}

Ayrıca bkz.

Görevler

İzlenecek yol: Bölüm 1 bir öğe şablonu ile bir özel eylem proje öğesi oluşturma

İzlenecek yol: Server Explorer'da görünen Web bölümlerini genişletme

Kavramlar

Programlama ile ilgili kavramlar ve Özellikler SharePoint Araçlar uzantıları

Nasıl yapılır: SharePoint projeleri için özellik eklemek

Nasıl yapılır: bir özel SharePoint proje öğe türü için bir özellik ekleme

Aracılığıyla paylaş