SPFieldLinkCollection.Add method
SPFieldLink物件加入集合中。
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'宣告
Public Sub Add ( _
fieldLink As SPFieldLink _
)
'用途
Dim instance As SPFieldLinkCollection
Dim fieldLink As SPFieldLink
instance.Add(fieldLink)
public void Add(
SPFieldLink fieldLink
)
參數
fieldLink
Type: Microsoft.SharePoint.SPFieldLink要加入至集合的欄位參考。引數不應該是 null 。
Exceptions
| Exception | Condition |
|---|---|
| SPException | 您要加入至集合物件的Name屬性的值會複製物件已經存在於集合中的 [ Name ] 屬性的值。 -或- SPFieldLink物件參考超出範圍，此內容類型的欄位。 |
備註
集合中的物件的索引是由內部名稱 ( SPFieldLink.Name屬性的值)。如果您嘗試加入的物件具有相同內部名稱已經存在於集合中的物件，這個方法會擲回例外狀況。由於SPFieldLink.Name屬性的值是它所參考的SPField物件的 [ InternalName ] 屬性相同，這項限制有效可確保內容的型別不能兩次參考相同的欄位。
如果它是次要的對應 (亦即，如果IsDependentLookup屬性會傳回true)，您無法直接新增欄位的型別SPFieldLookup 。若要在多個資料行對應中新增次要的查閱欄位，加入主要查詢] 欄位 ( IsDependentLookup屬性會傳回false)。所有主要的查閱欄位而定的次要的查閱欄位會自動加入。
Examples
下列範例會驗證是否內容型別已經連結到欄位的方法。如果不存在，方法會建立連結，並將它加入至內容的型別集合。
包含此範例應用程式匯入的System和Microsoft.Sharepoint命名空間。
Function LinkToField(ByRef field As SPField, ByRef contentType As SPContentType) As SPFieldLink
' Is the FieldLink in the collection?
Dim fieldLink As SPFieldLink = contentType.FieldLinks(field.Id)
If fieldLink Is Nothing Then ' No, so add it.
fieldLink = New SPFieldLink(field)
contentType.FieldLinks.Add(fieldLink)
End If
Return fieldLink
End Function
static SPFieldLink LinkToField(SPField field, SPContentType contentType)
{
// Is the FieldLink in the collection?
SPFieldLink fieldLink = contentType.FieldLinks[field.Id];
if (fieldLink == null) // No, so add it.
{
fieldLink = new SPFieldLink(field);
contentType.FieldLinks.Add(fieldLink);
}
return fieldLink;
}
請參閱
參照
Microsoft.SharePoint namespace