(ClientRuntimeContext, String, String, String, Int32, Boolean, Boolean, Boolean, String, String) del método Web.ShareObject

Artículo
05/09/2016

Comparte un objeto en SharePoint como un documento o sitio con usuarios externos.

Espacio de nombres: Microsoft.SharePoint.Client
Ensamblados: Microsoft.SharePoint.Client.Silverlight (en Microsoft.SharePoint.Client.Silverlight.dll); Microsoft.SharePoint.Client.Phone (en Microsoft.SharePoint.Client.Phone.dll)

Sintaxis

'Declaración
Public Shared Function ShareObject ( _
    context As ClientRuntimeContext, _
    url As String, _
    peoplePickerInput As String, _
    roleValue As String, _
    groupId As Integer, _
    propagateAcl As Boolean, _
    sendEmail As Boolean, _
    includeAnonymousLinkInEmail As Boolean, _
    emailSubject As String, _
    emailBody As String _
) As SharingResult
'Uso
Dim context As ClientRuntimeContext
Dim url As String
Dim peoplePickerInput As String
Dim roleValue As String
Dim groupId As Integer
Dim propagateAcl As Boolean
Dim sendEmail As Boolean
Dim includeAnonymousLinkInEmail As Boolean
Dim emailSubject As String
Dim emailBody As String
Dim returnValue As SharingResult

returnValue = Web.ShareObject(context, _
    url, peoplePickerInput, roleValue, _
    groupId, propagateAcl, sendEmail, _
    includeAnonymousLinkInEmail, emailSubject, _
    emailBody)

public static SharingResult ShareObject(
    ClientRuntimeContext context,
    string url,
    string peoplePickerInput,
    string roleValue,
    int groupId,
    bool propagateAcl,
    bool sendEmail,
    bool includeAnonymousLinkInEmail,
    string emailSubject,
    string emailBody
)

Parámetros

context
Tipo: Microsoft.SharePoint.Client.ClientRuntimeContext

Consulte ClientRuntimeContext

url
Tipo: System.String

La dirección URL completa del sitio Web o el documento que se comparte. Ejemplos:

 //  for sharing a website
http://contoso.sharepoint.com/sites/extranet1

// for sharing a document
https://contoso.sharepoint.com/sites/extranet1/shared%20documents/mydoc.xlsx

peoplePickerInput
Tipo: System.String

Una cadena de JSON con formato de los usuarios que representen de datos en formato de selector de personas. El siguiente es un ejemplo, pero se recomienda que siga las instrucciones en las API de uso compartida externa para SharePoint y OneDrive para la empresa y los ejemplos de código vinculados a ella para aprender a generó este objeto.

[{
  "Key" : "i:0#.f|membership|somebody.onmicrosoft.com#ext#@somedomain.com", 
  "Description" : "myDomain.onmicrosoft.com#EXT#@somedomain.com", 
  "DisplayText" : "Some Body", 
  "EntityType" : "User", 
  "ProviderDisplayName" : "Tenant", 
  "ProviderName" : "Tenant", 
  "IsResolved" : true, 
  "EntityData" : {
      "MobilePhone" : "", 
      "Email" : "somebody@myDomain.onmicrosoft.com", 
      "Department" : "", "Title" : "somebody@myDomain.onmicrosoft.com", 
      "PrincipalType" : "GUEST_USER"
    }, 
  "MultipleMatches" : []
}]

roleValue
Tipo: System.String

El valor de la función de uso compartido para el tipo de permiso para conceder en el objeto.

Si comparte un documento debe usar uno de los siguientes valores:
- "rol: 1073741827"
- "rol: 1073741826"
Al compartir un sitio, use después de formato. Reemplazar el marcador de posición {ID} con el identificador único grupo desde el sitio donde se asignará usuario externo.

”group:{groupId}”

groupId
Tipo: System.Int32

El identificador del grupo se agregue a. Utilice cero si no se agrega a un grupo de permisos. (Actualmente, se omite este valor).

propagateAcl
Tipo: System.Boolean

Un indicador para determinar si los permisos deben enviarse a elementos con permisos únicos.

sendEmail
Tipo: System.Boolean

Marcar para determinar si debe ser una notificación de correo electrónico enviado, si está configurado el correo electrónico.

includeAnonymousLinkInEmail
Tipo: System.Boolean

Si se envía un correo electrónico, determina si se debe agregar un vínculo de anónimo al mensaje.

emailSubject
Tipo: System.String

Texto de la línea de asunto del correo electrónico. (Actualmente, se omite este valor).

emailBody
Tipo: System.String

Texto del cuerpo del mensaje de correo.

Valor devuelto

Tipo: Microsoft.SharePoint.Client.SharingResult
Un objeto SharingResult que contiene la secuencia de comandos de finalización y una página para redirigir a opcional.