del método SPRunningJobCollection.GetInstance

Artículo
05/13/2015

Obtiene una instancia de un objeto SPRunningJob o produce una excepción si el objeto no existe.

Espacio de nombres: Microsoft.SharePoint.Administration
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)

Sintaxis

'Declaración
Public Function GetInstance ( _
    jobDefinitionId As Guid, _
    serverName As String _
) As SPRunningJob
'Uso
Dim instance As SPRunningJobCollection
Dim jobDefinitionId As Guid
Dim serverName As String
Dim returnValue As SPRunningJob

returnValue = instance.GetInstance(jobDefinitionId, _
    serverName)

public SPRunningJob GetInstance(
    Guid jobDefinitionId,
    string serverName
)

Parámetros

jobDefinitionId
Tipo: System.Guid

Guid del objeto SPJobDefinition que representa el trabajo que se está ejecutando.

serverName
Tipo: System.String

String que representa el nombre de la SPServer en el que se ejecuta el trabajo.

Valor devuelto

Tipo: Microsoft.SharePoint.Administration.SPRunningJob
Un objeto SPRunningJob que representa esta instancia.

Excepciones

Excepción	Condición
ArgumentOutOfRangeException	Parámetro no válido o trabajo sólo se ha eliminado.

Comentarios

Puede haber varias instancias en varios servidores o el trabajo podría estar limitado a una instancia en ejecución en la granja de servidores a la vez.

Ejemplos

En el ejemplo de código siguiente se recorre en iteración los servicios en una granja de servidores de SharePoint Foundation para mostrar información sobre cada trabajo que se ejecuta para cada servicio, o que aún no se ha eliminado de la SPRunningJobCollection asociados con cada servicio. Objetos de SPRunningJob , es de toda la interacción mediante programación con las propiedades; hay métodos disponibles en el objeto SPRunningJobCollection que permiten al implementador interactuar con una instancia específica de un objeto SPRunningJob .

[C#]

SPFarm farm = SPFarm.Local.Farm;
SPServiceCollection services = SPFarm.Local.Services;
int rand_job;
Guid jobdefid;
SPRunningJob rj;
string servername;
string svc_name = string.Empty;
 foreach (SPService service in services) {
  SPRunningJobCollection runningJobs = service.RunningJobs;
  if (runningJobs.Count > 0) {
    if (svc_name == string.Empty) {
       svc_name = service.Name;
    }
    Console.WriteLine("****Job Collection Count is     " + runningJobs.Count);
    Console.WriteLine("****Job Collection Service is   " + runningJobs.Service);
    // For the GetInstance method, save off job information at random
    rand_job = runningJobs.Count / 2;
    Console.WriteLine("****Collection member " + rand_job + " is " + runningJobs[rand_job].JobDefinition);
    jobdefid = runningJobs[rand_job].JobDefinitionId;
    servername = runningJobs[rand_job].ServerName;
  }
  else {
    jobdefid = Guid.Empty;
    servername = null;
  }
  foreach (SPRunningJob runningJob in runningJobs) {
    Console.WriteLine("****Job Id is           " + runningJob.JobDefinitionId);
  }
  if (jobdefid != Guid.Empty) {
    // random jobdef from collection 
    // getinstance method
    rj = runningJobs.GetInstance(jobdefid, servername);
    Console.WriteLine("*@@* Job Definition is   " + rj.JobDefinition);
    Console.WriteLine("*@@* Job Id is           " + rj.JobDefinitionId);
    Console.WriteLine("*@@* Job Title is        " + rj.JobDefinitionTitle);
  }
}