SPFieldLinkCollection.Reorder method

發行項
05/05/2015

變更表單會列出這個集合中所參考的欄位的順序。

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

Syntax

'宣告
Public Sub Reorder ( _
    internalNames As String() _
)
'用途
Dim instance As SPFieldLinkCollection
Dim internalNames As String()

instance.Reorder(internalNames)

public void Reorder(
    string[] internalNames
)

參數

internalNames
Type: []

字串陣列，每個包含在此SPFieldLinkCollection物件的Name屬性的值。

Exceptions

Exception	Condition
ArgumentNullException	internalNames是 null 。

備註

您可以使用這個方法來變更表單，例如在清單上的新項目表單顯示欄位的順序。做為引數傳遞至方法的字串集合必須包含在SPFieldLinkCollection中的物件所參考的欄位的內部名稱。您可以存取集合中每個物件的Name屬性，以取得內部名稱的清單。

如果您傳遞不完整的清單，方法會放置在您清單中的集合，其名稱不會出現在清單中的任何物件之前的第一個部分中命名的物件。如果您的清單包含不會出現在集合中的名稱，名稱會被忽略。

Examples

下列範例會變更 [宣布] 清單中先放入 [期限] 欄位，並進行必要的欄位中的預設內容類型的欄位順序。Announcement的內容類型的預設順序是「標題、本文、到期日」。程式碼範例會變更的順序，「到期日，標題、本文」。請注意此處所需的變更作業也可藉由傳遞「到期日，標題」的只有兩個字串的陣列。

包含這個程式碼範例應用程式匯入的System和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();
    }
}