SPFieldLinkCollection.Reorder-Methode

Artikel
05/06/2015

Ändert die Reihenfolge, in der Felder, auf die in dieser Auflistung verweist auf Formulare aufgeführt sind.

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

Syntax

'Declaration
Public Sub Reorder ( _
    internalNames As String() _
)
'Usage
Dim instance As SPFieldLinkCollection
Dim internalNames As String()

instance.Reorder(internalNames)

public void Reorder(
    string[] internalNames
)

Parameter

internalNames
Typ: []

Ein Array von Zeichenfolgen, die jeder mit dem Wert der Name -Eigenschaft für ein Objekt in dieser SPFieldLinkCollection.

Ausnahmen

Ausnahme	Bedingung
ArgumentNullException	internalNames ist Null .

Hinweise

Sie können diese Methode verwenden, ändern die Reihenfolge, in der Felder in Formularen wie das Formular Neues Element in einer Liste angezeigt werden. Die Auflistung von Zeichenfolgen, die Sie als Argument an die-Methode übergeben muss die internen Namen der Felder enthalten, durch die Objekte in der SPFieldLinkCollectionverwiesen wird. Sie können eine Liste der internen Namen abrufen, indem Sie den Zugriff auf die Name -Eigenschaft für jedes Objekt in der Auflistung.

Wenn Sie eine unvollständige Liste übergeben, platziert die Methode der Objekte mit dem Namen in der Liste im ersten Teil der Auflistung, vor alle Objekte, deren Namen nicht in der Liste angezeigt werden. Wenn Ihre Liste einen Namen, der nicht in der Auflistung angezeigt wird enthält, wird der Name ignoriert.

Beispiele

Das folgende Beispiel ändert die Reihenfolge der Felder in den Standardinhaltstyp für die Ankündigungsliste, zuerst das Expires-Feld einfügen und leicht Feld als Pflichtfeld fest. Die Standardreihenfolge im Announcement Inhaltstyp ist "Titel, Body, Expires." Im Codebeispiel ändert die Reihenfolge auf "Expires, Titel, Textkörper". Beachten Sie, dass die Änderung gewünscht hier auch durchgeführt werden kann, indem Sie ein Array mit nur zwei Zeichenfolgen, "Expires, Titel" übergeben.

Die Anwendung, die in diesem Codebeispiel enthält importiert die Namespaces System und Microsoft.Sharepoint .

Dim site As SPSite = New SPSite("https://localhost")
Try
    Dim web As SPWeb = site.OpenWeb()
    Try
        Dim ct As SPContentType = web.Lists("Announcements").ContentTypes("Announcement")
        Dim flinks As SPFieldLinkCollection = ct.FieldLinks

        ' Put the Expires field first and make it required.
        flinks.Reorder(New String() {"Expires", "Title", "Body"})
        flinks("Expires").Required = True
        ct.Update()
        
    Finally
        web.Dispose()
    End Try
Finally
    site.Dispose()
End Try

using (SPSite site = new SPSite("https://localhost"))
{
    using (SPWeb web = site.OpenWeb())
    {
        SPContentType ct = web.Lists["Announcements"].ContentTypes["Announcement"];
        SPFieldLinkCollection flinks = ct.FieldLinks;

        // Put the Expires field first and make it required.
        flinks.Reorder(new[]{"Expires", "Title", "Body"});
        flinks["Expires"].Required = true;
        ct.Update();
    }
}