Clase JobSchedule
The JobSchedule class represents a SQL Server Agent job schedule.
Jerarquía de herencia
System. . :: . .Object
Microsoft.SqlServer.Management.Smo. . :: . .SmoObjectBase
Microsoft.SqlServer.Management.Smo. . :: . .SqlSmoObject
Microsoft.SqlServer.Management.Smo. . :: . .NamedSmoObject
Microsoft.SqlServer.Management.Smo.Agent. . :: . .AgentObjectBase
Microsoft.SqlServer.Management.Smo.Agent. . :: . .ScheduleBase
Microsoft.SqlServer.Management.Smo.Agent..::..JobSchedule
Espacio de nombres: Microsoft.SqlServer.Management.Smo.Agent
Ensamblado: Microsoft.SqlServer.Smo (en Microsoft.SqlServer.Smo.dll)
Sintaxis
'Declaración
<SfcElementTypeAttribute("Schedule")> _
Public NotInheritable Class JobSchedule _
Inherits ScheduleBase _
Implements IAlterable, ICreatable, IDroppable, IRenamable, _
IScriptable
'Uso
Dim instance As JobSchedule
[SfcElementTypeAttribute("Schedule")]
public sealed class JobSchedule : ScheduleBase,
IAlterable, ICreatable, IDroppable, IRenamable, IScriptable
[SfcElementTypeAttribute(L"Schedule")]
public ref class JobSchedule sealed : public ScheduleBase,
IAlterable, ICreatable, IDroppable, IRenamable, IScriptable
[<SealedAttribute>]
[<SfcElementTypeAttribute("Schedule")>]
type JobSchedule =
class
inherit ScheduleBase
interface IAlterable
interface ICreatable
interface IDroppable
interface IRenamable
interface IScriptable
end
public final class JobSchedule extends ScheduleBase implements IAlterable, ICreatable, IDroppable, IRenamable, IScriptable
El tipo JobSchedule expone los siguientes miembros.
Constructores
Nombre | Descripción | |
---|---|---|
JobSchedule() () () () | Initializes a new instance of the JobSchedule class. | |
JobSchedule(SqlSmoObject, String) | Initializes a new instance of the JobSchedule class for the specified parent object and that has the specified name. |
Arriba
Propiedades
Nombre | Descripción | |
---|---|---|
ActiveEndDate | Gets or sets the date and time when the schedule ends. | |
ActiveEndTimeOfDay | Gets or sets the time when the job schedule stops for the day. | |
ActiveStartDate | Gets or sets the date and time when the schedule starts. | |
ActiveStartTimeOfDay | Gets or sets the time when the job schedule starts for the day. | |
DateCreated | Gets the date and time when the job schedule was created. | |
ExecuteForScalar | Obtiene o establece el valor de propiedad Boolean que especifica si el objeto está establecido para que se ejecute para la opción escalar. (Se hereda de SqlSmoObject.) | |
FrequencyInterval | Gets or sets the frequency interval, which determines how often the job is scheduled to run. | |
FrequencyRecurrenceFactor | Gets or sets the number of weeks or months between scheduled jobs for schedules with a weekly or monthly frequency type, respectively. | |
FrequencyRelativeIntervals | Gets or sets the ordinal value of a day relative to the first day of the month, such as first, second, or last. | |
FrequencySubDayInterval | Gets or sets the interval between scheduled jobs that run during the day. | |
FrequencySubDayTypes | Gets or sets the unit of time used to specify the interval between scheduled jobs that run during the day. | |
FrequencyTypes | Gets or sets the way in which frequency is evaluated for the job schedule, whether it's one time only, or weekly, or when the processor is idle, for example. | |
ID | No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. Gets the ID value that uniquely identifies the schedule. (Se hereda de ScheduleBase.) | |
IsEnabled | Gets or sets the Boolean property value that specifies whether the job schedule is enabled or disabled. | |
IsTouched | Obtiene el valor de propiedad Boolean que especifica si las propiedades del objeto se han actualizado pero todavía no son persistentes en el servidor. (Se hereda de SqlSmoObject.) | |
JobCount | Gets the number of jobs that require the referenced job schedule. | |
Name | Gets or sets the name of the object. (Se hereda de NamedSmoObject.) | |
ObjectInSpace | Obtiene el valor de propiedad Boolean que especifica si el objeto existe en aislamiento, o si está conectado directa o indirectamente con la instancia de SQL Server. (Se hereda de SqlSmoObject.) | |
Parent | Gets or sets the Job object that is the parent of the JobSchedule object. | |
Properties | Obtiene una colección de objetos Property que representa las propiedades del objeto. (Se hereda de SqlSmoObject.) | |
ScalarResult | Obtiene el resultado escalar para el objeto al que se hace referencia. (Se hereda de SqlSmoObject.) | |
ScheduleUid | Gets and sets the Guid for the schedule associated with the instance. | |
State | Gets the state of the referenced object. (Se hereda de SmoObjectBase.) | |
Urn | Obtiene el valor de la dirección URN (nombre de recursos uniforme) que identifica de forma única el objeto. (Se hereda de SqlSmoObject.) | |
UserData | Gets or sets user-defined data associated with the referenced object. (Se hereda de SmoObjectBase.) |
Arriba
Métodos
Nombre | Descripción | |
---|---|---|
AddDatabaseContext(StringCollection) | Agrega el contexto de la base de datos a la colección de consultas identificada por el parámetro queries. (Se hereda de SqlSmoObject.) | |
AddDatabaseContext(StringCollection, ScriptingOptions) | Agrega el contexto de la base de datos a la colección de consultas identificada por el parámetro queries usando las opciones de scripting especificadas. (Se hereda de SqlSmoObject.) | |
Alter | Updates any JobSchedule object property changes on an instance of Microsoft SQL Server. | |
AlterImpl | Activa el evento de objeto modificado. (Se hereda de SqlSmoObject.) | |
AlterImplFinish | Método al que se llama cuando finaliza el evento de objeto modificado. (Se hereda de SqlSmoObject.) | |
AlterImplInit | Método al que se llama cuando se inicializa el evento de objeto modificado. (Se hereda de SqlSmoObject.) | |
AlterImplWorker | Llama a los métodos Alter. (Se hereda de SqlSmoObject.) | |
BindDefaultImpl | Enlaza los elementos predeterminados identificados por los parámetros. (Se hereda de SqlSmoObject.) | |
BindRuleImpl | Enlaza el esquema de la regla a la regla y las columnas identificadas por los parámetros. (Se hereda de SqlSmoObject.) | |
CheckCollation | Comprueba el orden de las opciones de scripting por el método de intercalación identificado por el parámetro collationName. (Se hereda de SqlSmoObject.) | |
CheckObjectState() () () () | Valida el estado del objeto al que se hace referencia. (Se hereda de SqlSmoObject.) | |
CheckObjectState(Boolean) | Valida el estado del objeto al que se hace referencia, con la opción de especificar que se produzca una excepción si todavía no se ha creado el objeto. (Se hereda de SqlSmoObject.) | |
CheckObjectStateImpl | Comprueba el estado de un objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
CheckVersion100 | Comprueba si la versión de SQL Server es SQL Server 2008. (Se hereda de SqlSmoObject.) | |
CheckVersion80 | Comprueba la validez del objeto en SQL Server 2000. (Se hereda de SqlSmoObject.) | |
CheckVersion80SP3 | Comprueba la validez del objeto en SQL Server 2000 SP3. (Se hereda de SqlSmoObject.) | |
CheckVersion90 | Comprueba la validez del objeto en SQL Server 2005. (Se hereda de SqlSmoObject.) | |
CheckVersionBelow90 | Comprueba si la versión de SQL Server es anterior a SQL Server 2005. (Se hereda de SqlSmoObject.) | |
CleanObject | Establece el objeto en el estado no modificado. (Se hereda de SqlSmoObject.) | |
Create | Creates a job schedule on the instance of SQL Server as defined by the JobSchedule object. | |
CreateImpl | Crea un objeto con opciones de scripting. (Se hereda de SqlSmoObject.) | |
CreateImplFinish | Método al que se llama cuando finaliza el evento Create. (Se hereda de SqlSmoObject.) | |
CreateImplInit | Método al que se llama cuando se inicializa el evento Create. (Se hereda de SqlSmoObject.) | |
Discover | Detecta una lista del tipo Object. (Se hereda de SqlSmoObject.) | |
Drop() () () () | Removes the referenced job schedule. | |
Drop(Boolean) | Removes the referenced job schedule. | |
DropImpl | Quita un SqlSmoObject. (Se hereda de SqlSmoObject.) | |
DropImplWorker | Llama a los métodos Drop. (Se hereda de SqlSmoObject.) | |
EnumJobReferences | Returns an enumerated list of jobs that reference the schedule. | |
EnumScriptImpl | Enumera los scripts especificados por el parámetro so. (Se hereda de SqlSmoObject.) | |
EnumScriptImplWorker | Llama a los métodos que enumeran los scripts especificados por el parámetro so. (Se hereda de SqlSmoObject.) | |
EnumScriptImplWorkerSOChanged | Devuelve una cadena IEnumerable que describe las opciones de scripting de un objeto. (Se hereda de SqlSmoObject.) | |
Equals | (Se hereda de Object.) | |
ExecuteNonQuery | (Se hereda de SqlSmoObject.) | |
Finalize | (Se hereda de Object.) | |
FormatSqlVariant | Da formato a un objeto como tipo SqlVariant. (Se hereda de SqlSmoObject.) | |
GenerateDataSpaceFileStreamScript | Genera un script para crear el archivo de datos. (Se hereda de SqlSmoObject.) | |
GenerateDataSpaceScript | Genera un script para asignar espacio en el archivo de datos. (Se hereda de SqlSmoObject.) | |
GetBindDefaultScript | Obtiene el script que enlaza los valores predeterminados especificados por los parámetros defSchema y defName. (Se hereda de SqlSmoObject.) | |
GetBindRuleScript | Obtiene el script que especifica las reglas de enlace. (Se hereda de SqlSmoObject.) | |
GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%) | Asigna un parámetro booleano del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) | Asigna una propiedad booleana del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
GetDateTimeParameter | Asigna la propiedad datetime del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
GetDateTimeParameterAsInt | Asigna la propiedad datetime del objeto SqlSmoObject como un valor entero si la propiedad datetime no es NULL. (Se hereda de SqlSmoObject.) | |
GetDBName | No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. Gets the database name that is associated with the object. (Se hereda de AgentObjectBase.) | |
GetEnumParameter | Asigna una propiedad enumeration del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
GetFragOptionString | Obtiene un objeto FragmentationOption como un valor de cadena. (Se hereda de SqlSmoObject.) | |
GetGuidParameter | Asigna una propiedad Guid del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
GetHashCode | (Se hereda de Object.) | |
GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%) | Asigna un parámetro del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) | Asigna un parámetro del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
GetPropValue | Obtiene un valor de propiedad del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
GetPropValueOptional | Obtiene un valor de propiedad del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
GetPropValueOptionalAllowNull | Obtiene un valor de propiedad del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
GetRealValue | Obtiene un valor de propiedad del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
GetScriptingOptionsForCreate | Obtiene ScriptingOptions para el objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
GetServerName | Obtiene el nombre de la instancia de SQL Server con la que está asociado el objeto. (Se hereda de SqlSmoObject.) | |
GetServerObject | Obtiene el servidor del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
GetSqlServerVersionName | Obtiene el nombre de la versión de la instancia de SQL Server con la que está asociado el objeto. (Se hereda de SqlSmoObject.) | |
GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%) | Asigna un parámetro de cadena del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) | Asigna un parámetro de cadena del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
GetTimeSpanParameterAsInt | Asigna un parámetro de intervalo de tiempo del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
GetType | (Se hereda de Object.) | |
GetUrnRecursive(StringBuilder) | Asigna un objeto Urn del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
GetUrnRecursive(StringBuilder, UrnIdOption) | Asigna un objeto Urn del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
ImplInitialize | Inicializa los campos del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
Initialize() () () () | Inicializa el objeto y fuerza la carga de las propiedades. (Se hereda de SqlSmoObject.) | |
Initialize(Boolean) | Inicializa el objeto y fuerza la carga de las propiedades. (Se hereda de SqlSmoObject.) | |
IsObjectDirty | Comprueba si se han modificado las propiedades del objeto y los cambios todavía no son persistentes en la instancia de SQL Server. (Se hereda de SqlSmoObject.) | |
IsObjectInitialized | Comprueba si se ha inicializado el objeto. (Se hereda de SqlSmoObject.) | |
IsObjectInSpace | Comprueba si el objeto está aislado o conectado a la instancia de SQL Server. (Se hereda de SqlSmoObject.) | |
IsVersion80SP3 | Determina si la versión de SQL Server es SQL Server 2000 con SP3. (Se hereda de SqlSmoObject.) | |
IsVersion90AndAbove | Determina si la versión de SQL Server es SQL Server 2005 o posterior. (Se hereda de SqlSmoObject.) | |
MarkDropped | Establece SqlSmoState en quitado. (Se hereda de SqlSmoObject.) | |
MarkForDropImpl | Establece SqlSmoState en quitado. (Se hereda de SqlSmoObject.) | |
MemberwiseClone | (Se hereda de Object.) | |
PostAlter | Método que se activa tras modificar el objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
PostCreate | Método que se activa tras crear el objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
PostDrop | Método que se activa tras quitar el objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
Refresh | Actualiza el objeto y recupera las propiedades la próxima vez que se tiene acceso al objeto. (Se hereda de SqlSmoObject.) | |
Rename | Renames the job schedule. | |
RenameImpl | Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada. (Se hereda de NamedSmoObject.) | |
RenameImplWorker | Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada. (Se hereda de NamedSmoObject.) | |
Script() () () () | Generates a Transact-SQL script that can be used to re-create the SQL Server Agent job schedule. | |
Script(ScriptingOptions) | Generates a Transact-SQL script that can be used to re-create the SQL Server Agent job schedule as specified by the scripting options. | |
ScriptAlter | Modifica el objeto SqlSmoObject de acuerdo con los parámetros. (Se hereda de SqlSmoObject.) | |
ScriptChangeOwner | This method supports the SMO infrastructure and is not intended to be used directly from your code. (Se hereda de NamedSmoObject.) | |
ScriptCreate | Modifica el objeto SqlSmoObject de acuerdo con los parámetros. (Se hereda de SqlSmoObject.) | |
ScriptDdl | Inicia InvalidSmoOperationException. (Se hereda de SqlSmoObject.) | |
ScriptDrop | Inicia InvalidSmoOperationException. (Se hereda de SqlSmoObject.) | |
ScriptImpl() () () () | Obtiene una colección de los scripts del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
ScriptImpl(ScriptingOptions) | Obtiene una colección de los scripts del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
ScriptImplWorker | Obtiene una colección de los scripts del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
ScriptOwner | Alters the script owner authorization. (Se hereda de NamedSmoObject.) | |
ScriptRename | This method supports the SMO infrastructure and is not intended to be used directly from your code. (Se hereda de NamedSmoObject.) | |
SetId | No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. Sets the ID value that uniquely identifies the schedule. (Se hereda de ScheduleBase.) | |
SetParentImpl | Establece el elemento primario del objeto SqlSmoObject en el parámetro newParent. (Se hereda de SqlSmoObject.) | |
SetSchemaOwned | Sets the schema owned value. (Se hereda de NamedSmoObject.) | |
ToString | Devuelve un valor String que representa el objeto al que se hace referencia. (Se hereda de SqlSmoObject.) | |
TouchImpl | No implementado. (Se hereda de SqlSmoObject.) | |
UnbindDefaultImpl | Desenlaza las columnas predeterminadas del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
UnbindRuleImpl | Desenlaza las reglas del objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
Validate | Validates the state of an object. (Se hereda de SmoObjectBase.) |
Arriba
Eventos
Nombre | Descripción | |
---|---|---|
PropertyChanged | Representa el evento que se produce cuando se cambia una propiedad. (Se hereda de SqlSmoObject.) | |
PropertyMetadataChanged | Representa el evento que se produce cuando cambian los metadatos de la propiedad. (Se hereda de SqlSmoObject.) |
Arriba
Campos
Nombre | Descripción | |
---|---|---|
m_ExtendedProperties | Representa una propiedad definida para extender las propiedades proporcionadas por un objeto SqlSmoObject. (Se hereda de SqlSmoObject.) | |
singletonParent | Representa el elemento primario singleton. (Se hereda de SqlSmoObject.) |
Arriba
Implementaciones de interfaces explícitas
Nombre | Descripción | |
---|---|---|
IAlienObject. . :: . .Discover | Detecta las dependencias. No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. (Se hereda de SqlSmoObject.) | |
IAlienObject. . :: . .GetDomainRoot | Devuelve la raíz del dominio. (Se hereda de SqlSmoObject.) | |
IAlienObject. . :: . .GetParent | Obtiene el elemento primario de este objeto. No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. (Se hereda de SqlSmoObject.) | |
IAlienObject. . :: . .GetPropertyType | Obtiene el tipo de la propiedad especificada. (Se hereda de SqlSmoObject.) | |
IAlienObject. . :: . .GetPropertyValue | Obtiene el valor de la propiedad especificada. (Se hereda de SqlSmoObject.) | |
IAlienObject. . :: . .GetUrn | Obtiene el Nombre de recursos uniforme del objeto. No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. (Se hereda de SqlSmoObject.) | |
IAlienObject. . :: . .Resolve | Obtiene la instancia que contiene la información sobre el objeto del Nombre de recursos unificado del objeto. (Se hereda de SqlSmoObject.) | |
IAlienObject. . :: . .SetObjectState | Establece el estado del objeto en el valor SfcObjectState especificado. (Se hereda de SqlSmoObject.) | |
IAlienObject. . :: . .SetPropertyValue | Establece el valor de la propiedad. (Se hereda de SqlSmoObject.) | |
ISfcPropertyProvider. . :: . .GetPropertySet | Obtiene la referencia de interfaz al conjunto de propiedades de este objeto. No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. (Se hereda de SqlSmoObject.) |
Arriba
Comentarios
SQL Server Agent jobs can be scheduled to run by using SQL Server Agent. Jobs can be scheduled to run when SQL Server Agent is enabled, but jobs are not required to be scheduled. They can be run on demand by a sufficiently privileged user. Jobs can have more than one active schedule. SQL Server Agent evaluates all schedules to determine when to run the job. By using the JobSchedule object, you can do the following:
Create a schedule for a SQL Server Agent job.
Remove a schedule from an existing SQL Server Agent job.
Manage job schedules either by enabling a schedule or adjusting run times or frequencies.
To get or set JobSchedule object properties, users must be a member of the SQLAgentUserRole database role on the MSDB database, or be the owner of the job, or be a member of the sysadmin fixed server role.
To create a job schedule, users must be a member of the SQLAgentUserRole database role on the MSDB database, or be a member of the sysadmin fixed server role.
To drop a job schedule, users must be a member of the SQLAgentUserRole database role on the MSDB database, or be a member of the sysadmin fixed server role.
Thread Safety
Todos los miembros estáticos (compartidos en Microsoft Visual Basic) públicos de este tipo son seguros para operaciones multiproceso. No se garantiza que los miembros de instancia sean seguros para subprocesos.
Seguridad para subprocesos
Cualquier miembro público static (Shared en Visual Basic) de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.
Vea también