Olayları Script görev yükseltme
Olayları rapor hataları, uyarıları ve görev ilerleme veya durum, içeren paketin gibi diğer bilgileri sağlar. Paket, olay bildirimleri yönetmek için olay işleyicileri sağlar. Script görev üzerinde yöntemlerini çağırarak olayları yükseltebilirsiniz Eventsözelliği Dtsnesnesini. Hakkında daha fazla bilgi için Integration Servicespaketleri tanıtıcı etkinlikler, bakın SSIS paketi olay işleyicileri.
Herhangi bir günlük sağlayıcı paketi etkinleştirilmiş olayları kaydedilebilir. Günlüğü sağlayıcılarını olaylarla ilgili bilgileri bir veri deposunda saklar. Script görev-ebilmek da kullanma Logolay artırmadan için günlük sağlayıcı bilgileri günlüğe yöntemi. Nasıl kullanılacağı hakkında daha fazla bilgi için Logyöntemi, bakın Script görev günlüğe kaydetme.
Bir olay oluşturmak için Script görev çağrısı tarafından maruz yöntemlerden birini Eventsözellik. Tarafından kullandığı yöntemler aşağıdaki tabloda Eventsözellik.
Olay |
Açıklama |
---|---|
Kullanıcı tanımlı özel bir olay pakette yükseltir. |
|
Bir hata koşulu paketi bildirir. |
|
Kullanıcıya bilgi sağlar. |
|
Görev ilerleme paketi bildirir. |
|
Paket zamanından önce kapatmak için görev gerekip gerekmediğini gösteren bir değeri döndürür. |
|
Görev kullanıcı bildirim warrants ancak bir hata koşulu olmayan bir durumda paketi bildirir. |
Olayları örnek
Aşağıdaki örnek, içinde kod görev Olayları artırmak gösterilmiştir. Örnek, Internet bağlantısı mevcut olup olmadığını belirlemek için bir yerel Windows API işlevini kullanır. Bir bağlantı varsa, bir hata yükseltir. Örneğin, potansiyel uçucu modem bağlantısı kullanımda ise, bir uyarı yükseltir. Aksi takdirde Internet bağlantısı algılandı bir bilgilendirme iletisi döndürür.
Private Declare Function InternetGetConnectedState Lib "wininet" _
(ByRef dwFlags As Long, ByVal dwReserved As Long) As Long
Private Enum ConnectedStates
LAN = &H2
Modem = &H1
Proxy = &H4
Offline = &H20
Configured = &H40
RasInstalled = &H10
End Enum
Public Sub Main()
Dim dwFlags As Long
Dim connectedState As Long
Dim fireAgain as Boolean
connectedState = InternetGetConnectedState(dwFlags, 0)
If connectedState <> 0 Then
If (dwFlags And ConnectedStates.Modem) = ConnectedStates.Modem Then
Dts.Events.FireWarning(0, "Script Task Example", _
"Volatile Internet connection detected.", String.Empty, 0)
Else
Dts.Events.FireInformation(0, "Script Task Example", _
"Internet connection detected.", String.Empty, 0, fireAgain)
End If
Else
' If not connected to the Internet, raise an error.
Dts.Events.FireError(0, "Script Task Example", _
"Internet connection not available.", String.Empty, 0)
End If
Dts.TaskResult = ScriptResults.Success
End Sub
Private Declare Function InternetGetConnectedState Lib "wininet" _
(ByRef dwFlags As Long, ByVal dwReserved As Long) As Long
Private Enum ConnectedStates
LAN = &H2
Modem = &H1
Proxy = &H4
Offline = &H20
Configured = &H40
RasInstalled = &H10
End Enum
Public Sub Main()
Dim dwFlags As Long
Dim connectedState As Long
Dim fireAgain as Boolean
connectedState = InternetGetConnectedState(dwFlags, 0)
If connectedState <> 0 Then
If (dwFlags And ConnectedStates.Modem) = ConnectedStates.Modem Then
Dts.Events.FireWarning(0, "Script Task Example", _
"Volatile Internet connection detected.", String.Empty, 0)
Else
Dts.Events.FireInformation(0, "Script Task Example", _
"Internet connection detected.", String.Empty, 0, fireAgain)
End If
Else
' If not connected to the Internet, raise an error.
Dts.Events.FireError(0, "Script Task Example", _
"Internet connection not available.", String.Empty, 0)
End If
Dts.TaskResult = ScriptResults.Success
End Sub
using System;
using System.Data;
using Microsoft.SqlServer.Dts.Runtime;
using System.Windows.Forms;
using System.Runtime.InteropServices;
public class ScriptMain
{
[DllImport("wininet")]
private extern static long InternetGetConnectedState(ref long dwFlags, long dwReserved);
private enum ConnectedStates
{
LAN = 0x2,
Modem = 0x1,
Proxy = 0x4,
Offline = 0x20,
Configured = 0x40,
RasInstalled = 0x10
};
public void Main()
{
//
long dwFlags = 0;
long connectedState;
bool fireAgain = true;
int state;
connectedState = InternetGetConnectedState(ref dwFlags, 0);
state = (int)ConnectedStates.Modem;
if (connectedState != 0)
{
if ((dwFlags & state) == state)
{
Dts.Events.FireWarning(0, "Script Task Example", "Volatile Internet connection detected.", String.Empty, 0);
}
else
{
Dts.Events.FireInformation(0, "Script Task Example", "Internet connection detected.", String.Empty, 0, ref fireAgain);
}
}
else
{
// If not connected to the Internet, raise an error.
Dts.Events.FireError(0, "Script Task Example", "Internet connection not available.", String.Empty, 0);
}
Dts.TaskResult = (int)ScriptResults.Success;
}
using System;
using System.Data;
using Microsoft.SqlServer.Dts.Runtime;
using System.Windows.Forms;
using System.Runtime.InteropServices;
public class ScriptMain
{
[DllImport("wininet")]
private extern static long InternetGetConnectedState(ref long dwFlags, long dwReserved);
private enum ConnectedStates
{
LAN = 0x2,
Modem = 0x1,
Proxy = 0x4,
Offline = 0x20,
Configured = 0x40,
RasInstalled = 0x10
};
public void Main()
{
//
long dwFlags = 0;
long connectedState;
bool fireAgain = true;
int state;
connectedState = InternetGetConnectedState(ref dwFlags, 0);
state = (int)ConnectedStates.Modem;
if (connectedState != 0)
{
if ((dwFlags & state) == state)
{
Dts.Events.FireWarning(0, "Script Task Example", "Volatile Internet connection detected.", String.Empty, 0);
}
else
{
Dts.Events.FireInformation(0, "Script Task Example", "Internet connection detected.", String.Empty, 0, ref fireAgain);
}
}
else
{
// If not connected to the Internet, raise an error.
Dts.Events.FireError(0, "Script Task Example", "Internet connection not available.", String.Empty, 0);
}
Dts.TaskResult = (int)ScriptResults.Success;
}
|