SPMeeting.Add method (String, String, UInt32, String, String, String, String, String, Boolean, Int16)

Artigo
05/12/2015

Adiciona uma instância de reunião para o site de espaço de trabalho de reunião atual.

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

Syntax

'Declaração
Public Function Add ( _
    organizer As String, _
    uid As String, _
    sequence As UInteger, _
    dateStamp As String, _
    title As String, _
    location As String, _
    dateStart As String, _
    dateEnd As String, _
    nonGregorian As Boolean, _
    <OutAttribute> ByRef nMeetingCount As Short _
) As Integer
'Uso
Dim instance As SPMeeting
Dim organizer As String
Dim uid As String
Dim sequence As UInteger
Dim dateStamp As String
Dim title As String
Dim location As String
Dim dateStart As String
Dim dateEnd As String
Dim nonGregorian As Boolean
Dim nMeetingCount As Short
Dim returnValue As Integer

returnValue = instance.Add(organizer, _
    uid, sequence, dateStamp, title, location, _
    dateStart, dateEnd, nonGregorian, _
    nMeetingCount)

public int Add(
    string organizer,
    string uid,
    uint sequence,
    string dateStamp,
    string title,
    string location,
    string dateStart,
    string dateEnd,
    bool nonGregorian,
    out short nMeetingCount
)

Parâmetros

organizer
Type: System.String

Um string que contém o endereço de email do organizador da reunião, especificado como email_address@domain.ext. Esse parâmetro é usado em cenários de representante. Se o organizador da reunião não for um representante, você pode passar uma sequência vazia. Nesse caso, o usuário que executa o aplicativo é considerado como o organizador da reunião.

uid
Type: System.String

Um string que contém um identificador exclusivo (UID) para um evento de calendário, conforme especificado pela RFC 2445.

sequence
Type: System.UInt32

O número de sequência de revisão conforme especificado pelas 2445 RFC. Os números de sequência começam em zero e são incrementados a cada revisão. O número de sequência é usado para determinar a ordem das atualizações caso não chegam na ordem. Atualizações com um número de seqüência inferior que atual serão descartadas.

dateStamp
Type: System.String

Um string que representa a data e hora atuais. A data e hora devem ser expresso como tempo Universal Coordenado (UTC) no formato especificado pelo ISO 8601, da seguinte maneira: "yyyyMMdd'T 'Dos HHmmss Z'".

title
Type: System.String

O título (assunto) da reunião.

location
Type: System.String

O local da reunião.

dateStart
Type: System.String

Um string que representa a data e hora em que a reunião foi agendada para começar. A data e hora devem ser expresso como tempo Universal Coordenado (UTC) no formato especificado pelo ISO 8601, da seguinte maneira: "yyyyMMdd'T 'Dos HHmmss Z'".

dateEnd
Type: System.String

Um string que representa a data e hora em que a reunião foi agendada para encerrar. A data e hora devem ser posteriores dateStart. O valor deve ser expresso como tempo Universal Coordenado (UTC) no formato especificado pelo ISO 8601, da seguinte maneira: "yyyyMMdd'T 'Dos HHmmss Z'".

nonGregorian
Type: System.Boolean

true se o calendário estiver definido como um formato diferente gregoriano; Caso contrário, false.

nMeetingCount
Type: System.Int16

Uma referência a uma variável que receberá o número total de instâncias de reunião que estão associadas com o site de espaço de trabalho de reunião atual.

Valor retornado

Type: System.Int32
A ID da instância da reunião.

Comentários

O método Add cria uma nova instância de reunião no espaço de trabalho de reunião. Um compromisso não é adicionado ao calendário SharePoint Foundation.

Examples

O exemplo a seguir é um aplicativo de console que cria um site de espaço de trabalho de reunião e adiciona uma instância de reunião ao site.

Imports System
Imports Microsoft.SharePoint
Imports Microsoft.SharePoint.Meetings

Module ConsoleApp
   Sub Main()
      Using site As SPSite = New SPSite("https://localhost")
         Using web As SPWeb = site.OpenWeb()

            ' Set up meeting parameters.
            Dim dtStart As DateTime = DateTime.Now.AddDays(6)
            Dim stamp As String = ISO8601BasicDate(DateTime.Now)
            Dim startTime As String = ISO8601BasicDate(dtStart)
            Dim endTime As String = ISO8601BasicDate(dtStart.AddHours(1))

            Dim title As String = "Test Sharepoint"
            Dim location As String = "Your office"
            Dim organizer As String = String.Empty
            Dim uid As String = Guid.NewGuid().ToString("N")
            Dim sequence As System.UInt32 = 0

            ' Create an output variable.
            Dim meetingCount As Short

            ' Create a Meeting Workspace site.
            Dim mwsWeb As SPWeb = CreateWorkspace(web, "Test", "Test Workspace", "A test workspace", "MPS#0")

            ' Get the meeting information for the workspace.
            Dim meetingInfo As SPMeeting = SPMeeting.GetMeetingInformation(mwsWeb)

            ' Add the meeting.
            Dim instanceID As Integer = meetingInfo.Add(organizer, uid, sequence, stamp, _
                                                        title, location, startTime, endTime, _
                                                        False, meetingCount)
            ' Clean up.
            mwsWeb.Dispose()

            ' Print the URL and number of meetings.
            Dim url As String = mwsWeb.Url + "?InstanceID=" + instanceID.ToString()
            Console.WriteLine(url)
            Console.WriteLine("Meeting count = {0}", meetingCount)

         End Using
      End Using
      Console.Write(vbCrLf + "Press ENTER to continue...")
      Console.ReadLine()
   End Sub

   Function CreateWorkspace(ByRef webSite As SPWeb, ByVal url As String, _
                            ByVal title As String, ByVal description As String, _
                            ByVal template As String) As SPWeb
      Dim mws As SPWeb = Nothing
      Try
         mws = webSite.Webs.Add(url, title, description, _
                                CType(webSite.Locale.LCID, System.UInt32), template, _
                                False, False)
      Catch
         If SPMeeting.IsMeetingWorkspaceWeb(webSite.Webs(url)) Then
            mws = webSite.Webs(url)
         End If
      End Try
      Return mws
   End Function

   Function ISO8601BasicDate(ByVal dt As DateTime) As String
      Dim format As String = "yyyyMMdd'T'HHmmss'Z'"
      Dim dtUTC As DateTime = dt.ToUniversalTime()
      Return dtUTC.ToString(format, System.Globalization.DateTimeFormatInfo.InvariantInfo)
   End Function

End Module

using System;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Meetings;

namespace Test
{
   class ConsoleApp
   {
      static void Main(string[] args)
      {
         using (SPSite site = new SPSite("https://localhost"))
         {
            using (SPWeb web = site.OpenWeb())
            {
               // Define meeting parameters.
               DateTime dtStart = DateTime.Now.AddDays(5);
               string stamp = ISO8601BasicDate(DateTime.Now);
               string startTime = ISO8601BasicDate(dtStart);
               string endTime = ISO8601BasicDate(dtStart.AddHours(1));
               string title = "Test Sharepoint";
               string location = "Your office";
               string organizer = String.Empty;
               uint sequence = 0;
               string uid = Guid.NewGuid().ToString("N");

               // Create an output variable.
               short meetingCount;

               // Create a Meeting Workspace site.
               SPWeb mwsWeb = CreateWorkspace(web, "Test", "Test Workspace", "A test workspace", "MPS#0");

               // Get the meeting information for the workspace.
               SPMeeting meetingInfo = SPMeeting.GetMeetingInformation(mwsWeb);

               // Add the meeting.
               try
               {
                  int instanceID = meetingInfo.Add(organizer, uid, sequence,
                                               stamp, title, location,
                                               startTime, endTime, false,
                                               out meetingCount);

                  // Print the URL and number of meetings.
                  string url = mwsWeb.Url + "?InstanceID=" + instanceID.ToString();
                  Console.WriteLine(url);
                  Console.WriteLine("Meeting count = {0}", meetingCount);
               }
               catch (SPException ex)
               {
                  Console.WriteLine(ex.Message);
               }

               // Clean up.
               mwsWeb.Dispose();
            }
         }
         Console.Write("\nPress ENTER to continue...");
         Console.ReadLine();
      }

      static SPWeb CreateWorkspace(SPWeb webSite, string url, string title,
                                   string description, string template)
      {
         SPWeb mws = null;
         try
         {
            mws = webSite.Webs.Add(url, title, description,
                                   (uint)webSite.Locale.LCID, template,
                                   false, false);
         }
         catch (SPException) // A site of that name already exists.
         {
            if (SPMeeting.IsMeetingWorkspaceWeb(webSite.Webs[url]))
               mws = webSite.Webs[url];
         }
         return mws;
      }

      static string ISO8601BasicDate(DateTime dt)
      {
         string format = "yyyyMMdd'T'HHmmss'Z'";
         DateTime dtUTC = dt.ToUniversalTime();
         return dtUTC.ToString(format, System.Globalization.DateTimeFormatInfo.InvariantInfo);
      }

   }
}