Freigeben über


SPFieldLink.DisplayName-Eigenschaft

Ruft ab oder legt den Anzeigenamen für den Feldverweis.

Namespace:  Microsoft.SharePoint
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaration
Public Property DisplayName As String
    Get
    Set
'Usage
Dim instance As SPFieldLink
Dim value As String

value = instance.DisplayName

instance.DisplayName = value
public string DisplayName { get; set; }

Eigenschaftswert

Typ: System.String
Der Anzeigename des Verweises dar.

Hinweise

Wenn die DisplayName -Eigenschaft nicht explizit festgelegt wurde, wird den Wert, der das Objekt Name -Eigenschaft zurückgegeben.

Die Eigenschaft DisplayName erfüllt einen ähnlichen Zweck an, die von der SPField.Title -Eigenschaft. Beide Eigenschaften geben Sie einen Anzeigenamen für eine Spalte. Wenn Spalten in der Websitespaltenkatalog aufgeführt sind, werden die Namen in der Liste aus der Title -Eigenschaft für jedes SPField -Objekts in das Feld Websitesammlung geschaltet. Wenn auf der Seite Websiteinhaltstyp für einen bestimmten Inhaltstyp Spalten aufgeführt werden, werden die Namen von der DisplayName -Eigenschaft jedes SPFieldLink -Objekts in der Referenz Feldauflistung des Inhaltstyps geschaltet.

Wenn Sie eine Websitespalte zu einem Inhaltstyp hinzufügen, können Sie festlegen den Wert der DisplayName -Eigenschaft des SPFieldLink -Objekts auf einen Wert, der der Wert der Title -Eigenschaft des Objekts SPField unterscheidet ermöglicht den Inhaltstyp einen anderen Anzeigenamen für die gleichen Spaltendefinition verwenden.

Beispiele

Das folgende Beispiel zeigt eine Konsolenanwendung, die einen Inhaltstyp Company erstellt. Da der neue Inhaltstyp für den Inhaltstyp Item basiert, erbt es einen Verweis auf eine Websitespalte namens "Title". Die Anwendung ändert den Anzeigenamen dieser Spalte im Inhaltstyp Company aus "Title" zur "Company". Um sicherzustellen, dass der Anzeigename der Spalte Inhaltstyp jetzt anders als der angezeigte Name der Websitespalte ist, wird die Anwendung beide Namen in der Konsole gedruckt.

Imports System
Imports Microsoft.SharePoint

Module ConsoleApp

    Sub Main()
        Dim site As SPSite = New SPSite("https://localhost")
        Try
            Dim web As SPWeb = site.OpenWeb()
            Try
                ' Create a new content type.
                Dim companyType As New SPContentType(web.AvailableContentTypes("Item"), _
                                                     web.ContentTypes, "Company")
                web.ContentTypes.Add(companyType)

                ' Get the site field named Title.
                Dim field As SPField = web.Fields("Title")

                ' Get the same field in the content type.
                Dim fieldLink As SPFieldLink = companyType.FieldLinks(field.Id)

                ' Change the display name from Title to Company.
                fieldLink.DisplayName = "Company"
                companyType.Update()

                ' Verify our work.
                Console.WriteLine("The display name of the site column is {0}.", field.Title)
                Console.WriteLine("The display name of the content type column is {0}.", fieldLink.DisplayName)

            Finally
                web.Dispose()
            End Try
        Finally
            site.Dispose()
        End Try
        Console.Write("Press ENTER to continue...")
        Console.ReadLine()

    End Sub

End Module
using System;
using Microsoft.SharePoint;

namespace Test
{
    class ConsoleApp
    {
        static void Main(string[] args)
        {
            using (SPSite site = new SPSite("https://localhost"))
            {
                using (SPWeb web = site.OpenWeb())
                {   
                    // Create a new content type.
                    SPContentType companyType = new SPContentType(web.AvailableContentTypes["Item"],
                                                                  web.ContentTypes, "Company");
                    web.ContentTypes.Add(companyType);

                    // Get the site field named Title.
                    SPField field = web.Fields["Title"];

                    // Get the same field in the content type.
                    SPFieldLink fieldLink = companyType.FieldLinks[field.Id];

                    // Change the display name from Title to Company.
                    fieldLink.DisplayName = "Company";
                    companyType.Update();

                    // Verify our work.
                    Console.WriteLine("The display name of the site column is {0}.", field.Title);
                    Console.WriteLine("The display name of the content type column is {0}.", fieldLink.DisplayName);
                }
            }
            Console.Write("Press ENTER to continue...");
            Console.ReadLine();
        }
    }
}

Die folgende Ausgabe wird in der Konsole angezeigt.

The display name of the site column is Title.
The display name of the content type column is Company.
Press ENTER to continue...

Siehe auch

Referenz

SPFieldLink Klasse

SPFieldLink-Member

Microsoft.SharePoint-Namespace

Weitere Ressourcen

Fields and Field References

Introduction to Columns

Introduction to Content Types