Dreamine.IO.Fastech.Ethernet.Transport.UdpFastechEthernetIoTransport에 대한 상속 다이어그램 :

[범례]

Dreamine.IO.Fastech.Ethernet.Transport.UdpFastechEthernetIoTransport에 대한 협력 다이어그램:

[범례]

Public 멤버 함수
	UdpFastechEthernetIoTransport (FastechEthernetIoOptions options)
async Task< IoResult >	ConnectAsync (CancellationToken cancellationToken=default)
async Task< IoResult >	DisconnectAsync (CancellationToken cancellationToken=default)
async Task< IoResult< byte[]> >	SendAndReceiveAsync (IReadOnlyList< byte > requestFrame, int receiveTimeoutMs, int expectedResponseLength, CancellationToken cancellationToken=default)
async ValueTask	DisposeAsync ()

속성
bool	IsConnected `[get]`
byte[]	LastRequestFrame = [] `[get, private set]`
byte[]	LastResponseFrame = [] `[get, private set]`

Private 멤버 함수
Task	CloseCoreAsync ()
async Task< IPAddress >	ResolveRemoteAddressAsync (CancellationToken cancellationToken)
void	ThrowIfDisposed ()

정적 Private 멤버 함수
static void	DisableUdpConnectionReset (UdpClient client)

Private 속성
readonly SemaphoreSlim	_syncLock = new(1, 1)
readonly FastechEthernetIoOptions	_options
UdpClient?	_udpClient
IPEndPoint?	_remoteEndPoint
bool	_disposed

상세한 설명

Fastech Ezi-IO Plus-E 통신을 위한 UDP 전송을 제공합니다.

UdpFastechEthernetIoTransport.cs 파일의 16 번째 라인에서 정의되었습니다.

생성자 & 소멸자 문서화

◆ UdpFastechEthernetIoTransport()

Dreamine.IO.Fastech.Ethernet.Transport.UdpFastechEthernetIoTransport.UdpFastechEthernetIoTransport ( FastechEthernetIoOptions options )

inline

UdpFastechEthernetIoTransport 클래스의 새 인스턴스를 초기화합니다.

매개변수

options Fastech Ethernet I/O 연결 옵션입니다.

예외

ArgumentNullException options 가 null인 경우 발생합니다.

UdpFastechEthernetIoTransport.cs 파일의 88 번째 라인에서 정의되었습니다.

    {
        _options = options ?? throw new ArgumentNullException(nameof(options));
    }

다음을 참조함 : _options.

멤버 함수 문서화

◆ CloseCoreAsync()

Task Dreamine.IO.Fastech.Ethernet.Transport.UdpFastechEthernetIoTransport.CloseCoreAsync ( )

inlineprivate

내부 UDP 클라이언트를 닫고 끝점 참조를 초기화합니다.

반환값: 완료된 비동기 작업입니다.

UdpFastechEthernetIoTransport.cs 파일의 426 번째 라인에서 정의되었습니다.

    {
        _udpClient?.Dispose();
        _udpClient = null;
        _remoteEndPoint = null;
 
        return Task.CompletedTask;
    }

다음을 참조함 : _remoteEndPoint, _udpClient.

다음에 의해서 참조됨 : ConnectAsync(), DisconnectAsync().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ ConnectAsync()

async Task< IoResult > Dreamine.IO.Fastech.Ethernet.Transport.UdpFastechEthernetIoTransport.ConnectAsync ( CancellationToken cancellationToken = default )

inline

구성된 원격 끝점을 확인하고 UDP 클라이언트를 준비합니다.

매개변수

cancellationToken 연결 준비 취소를 관찰하는 토큰입니다.

반환값: 준비 성공 여부와 실패 메시지를 포함한 결과입니다.

예외

OperationCanceledException 동기화 잠금을 기다리는 동안 cancellationToken 이 취소된 경우 발생합니다.

Dreamine.IO.Fastech.Ethernet.Transport.IFastechEthernetIoTransport를 구현.

UdpFastechEthernetIoTransport.cs 파일의 155 번째 라인에서 정의되었습니다.

    {
        if (string.IsNullOrWhiteSpace(_options.Host))
        {
            return IoResult.Failure("The Fastech host must not be empty.");
        }
 
        if (_options.Port is <= 0 or > 65535)
        {
            return IoResult.Failure($"Invalid UDP port: {_options.Port}.");
        }
 
        if (_options.LocalPort is < 0 or > 65535)
        {
            return IoResult.Failure($"Invalid local UDP port: {_options.LocalPort}.");
        }
 
        await _syncLock.WaitAsync(cancellationToken).ConfigureAwait(false);
 
        try
        {
            ThrowIfDisposed();
 
            if (IsConnected)
            {
                return IoResult.Success();
            }
 
            var remoteAddress = await ResolveRemoteAddressAsync(cancellationToken).ConfigureAwait(false);
            _remoteEndPoint = new IPEndPoint(remoteAddress, _options.Port);
            _udpClient = _options.LocalPort == 0
                ? new UdpClient(remoteAddress.AddressFamily)
                : new UdpClient(_options.LocalPort, remoteAddress.AddressFamily);
 
            DisableUdpConnectionReset(_udpClient);
 
            return IoResult.Success();
        }
        catch (Exception ex)
        {
            await CloseCoreAsync().ConfigureAwait(false);
            return IoResult.Failure(ex.Message);
        }
        finally
        {
            _syncLock.Release();
        }
    }

다음을 참조함 : _options, _remoteEndPoint, _syncLock, _udpClient, CloseCoreAsync(), DisableUdpConnectionReset(), IsConnected, ResolveRemoteAddressAsync(), ThrowIfDisposed().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ DisableUdpConnectionReset()

void Dreamine.IO.Fastech.Ethernet.Transport.UdpFastechEthernetIoTransport.DisableUdpConnectionReset ( UdpClient client )

inlinestaticprivate

Windows에서 ICMP 포트 연결 불가 응답에 따른 UDP 연결 재설정 동작을 비활성화합니다.

매개변수

client 설정할 UDP 클라이언트입니다.

UdpFastechEthernetIoTransport.cs 파일의 497 번째 라인에서 정의되었습니다.

    {
        if (!OperatingSystem.IsWindows())
        {
            return;
        }
 
        try
        {
            const int sioUdpConnReset = -1744830452;
            client.Client.IOControl(sioUdpConnReset, [0], null);
        }
        catch (SocketException)
        {
        }
    }

다음에 의해서 참조됨 : ConnectAsync().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ DisconnectAsync()

async Task< IoResult > Dreamine.IO.Fastech.Ethernet.Transport.UdpFastechEthernetIoTransport.DisconnectAsync ( CancellationToken cancellationToken = default )

inline

현재 UDP 클라이언트와 원격 끝점 정보를 해제합니다.

매개변수

cancellationToken 연결 해제 취소를 관찰하는 토큰입니다.

반환값: 연결 해제 성공 여부와 실패 메시지를 포함한 결과입니다.

예외

OperationCanceledException 동기화 잠금을 기다리는 동안 cancellationToken 이 취소된 경우 발생합니다.

Dreamine.IO.Fastech.Ethernet.Transport.IFastechEthernetIoTransport를 구현.

UdpFastechEthernetIoTransport.cs 파일의 236 번째 라인에서 정의되었습니다.

    {
        await _syncLock.WaitAsync(cancellationToken).ConfigureAwait(false);
 
        try
        {
            await CloseCoreAsync().ConfigureAwait(false);
            return IoResult.Success();
        }
        catch (Exception ex)
        {
            return IoResult.Failure(ex.Message);
        }
        finally
        {
            _syncLock.Release();
        }
    }

다음을 참조함 : _syncLock, CloseCoreAsync().

다음에 의해서 참조됨 : DisposeAsync().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ DisposeAsync()

async ValueTask Dreamine.IO.Fastech.Ethernet.Transport.UdpFastechEthernetIoTransport.DisposeAsync ( )

inline

UDP 클라이언트와 동기화 리소스를 비동기적으로 해제합니다.

반환값: 비동기 해제 작업입니다.

UdpFastechEthernetIoTransport.cs 파일의 396 번째 라인에서 정의되었습니다.

    {
        if (_disposed)
        {
            return;
        }
 
        await DisconnectAsync().ConfigureAwait(false);
        _syncLock.Dispose();
        _disposed = true;
 
        GC.SuppressFinalize(this);
    }

다음을 참조함 : _disposed, _syncLock, DisconnectAsync().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ ResolveRemoteAddressAsync()

async Task< IPAddress > Dreamine.IO.Fastech.Ethernet.Transport.UdpFastechEthernetIoTransport.ResolveRemoteAddressAsync ( CancellationToken cancellationToken )

inlineprivate

구성된 호스트 이름 또는 IP 문자열을 원격 IP 주소로 확인합니다.

매개변수

cancellationToken DNS 조회 취소를 관찰하는 토큰입니다.

반환값: 확인된 IPv4 우선 IP 주소입니다.

예외

InvalidOperationException 호스트에서 사용할 수 있는 주소를 확인하지 못한 경우 발생합니다.

UdpFastechEthernetIoTransport.cs 파일의 467 번째 라인에서 정의되었습니다.

    {
        if (IPAddress.TryParse(_options.Host, out var address))
        {
            return address;
        }
 
        var addresses = await Dns.GetHostAddressesAsync(_options.Host, cancellationToken).ConfigureAwait(false);
        var resolvedAddress = addresses.FirstOrDefault(x => x.AddressFamily == AddressFamily.InterNetwork)
            ?? addresses.FirstOrDefault();
 
        return resolvedAddress ?? throw new InvalidOperationException($"Unable to resolve UDP host: {_options.Host}.");
    }

다음을 참조함 : _options.

다음에 의해서 참조됨 : ConnectAsync().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ SendAndReceiveAsync()

async Task< IoResult< byte[]> > Dreamine.IO.Fastech.Ethernet.Transport.UdpFastechEthernetIoTransport.SendAndReceiveAsync	(	IReadOnlyList< byte >	requestFrame,
		int	receiveTimeoutMs,
		int	expectedResponseLength,
		CancellationToken	cancellationToken = default )

inline

요청 데이터그램을 보내고 하나의 UDP 응답 데이터그램을 받습니다.

매개변수

requestFrame	전송할 요청 바이트입니다.
receiveTimeoutMs	밀리초 단위의 수신 제한 시간입니다.
expectedResponseLength	인터페이스 호환성을 위한 기대 응답 길이이며 UDP에서는 사용하지 않습니다.
cancellationToken	송수신 취소를 관찰하는 토큰입니다.

반환값: 수신 데이터그램 또는 실패 메시지를 포함한 결과입니다.

예외

ArgumentNullException	requestFrame 이 `null`인 경우 발생합니다.
OperationCanceledException	동기화 잠금을 기다리는 동안 cancellationToken 이 취소된 경우 발생합니다.

Dreamine.IO.Fastech.Ethernet.Transport.IFastechEthernetIoTransport를 구현.

UdpFastechEthernetIoTransport.cs 파일의 319 번째 라인에서 정의되었습니다.

    {
        ArgumentNullException.ThrowIfNull(requestFrame);
 
        if (requestFrame.Count == 0)
        {
            return IoResult<byte[]>.Failure("The request frame must not be empty.");
        }
 
        if (receiveTimeoutMs <= 0)
        {
            return IoResult<byte[]>.Failure("The receive timeout must be greater than zero.");
        }
 
        await _syncLock.WaitAsync(cancellationToken).ConfigureAwait(false);
 
        try
        {
            ThrowIfDisposed();
 
            if (_udpClient is null || _remoteEndPoint is null)
            {
                return IoResult<byte[]>.Failure("The Fastech UDP transport is not connected.");
            }
 
            var requestBuffer = requestFrame as byte[] ?? requestFrame.ToArray();
            LastRequestFrame = requestBuffer;
            LastResponseFrame = [];
 
            using var timeoutCts = CancellationTokenSource.CreateLinkedTokenSource(cancellationToken);
            timeoutCts.CancelAfter(receiveTimeoutMs);
 
            await _udpClient.SendAsync(requestBuffer, _remoteEndPoint, timeoutCts.Token).ConfigureAwait(false);
            var response = await _udpClient.ReceiveAsync(timeoutCts.Token).ConfigureAwait(false);
            LastResponseFrame = response.Buffer;
 
            return IoResult<byte[]>.Success(response.Buffer);
        }
        catch (OperationCanceledException ex)
        {
            return IoResult<byte[]>.Failure($"No UDP response from {_options.Host}:{_options.Port} within {receiveTimeoutMs} ms. {ex.Message}");
        }
        catch (SocketException ex) when (ex.SocketErrorCode == SocketError.ConnectionReset)
        {
            return IoResult<byte[]>.Failure(
                $"No UDP listener responded at {_options.Host}:{_options.Port}. Windows reported UDP reset/ICMP port unreachable. {ex.Message}");
        }
        catch (Exception ex)
        {
            return IoResult<byte[]>.Failure(ex.Message);
        }
        finally
        {
            _syncLock.Release();
        }
    }

다음을 참조함 : _remoteEndPoint, _syncLock, _udpClient, LastRequestFrame, LastResponseFrame, ThrowIfDisposed().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ ThrowIfDisposed()

void Dreamine.IO.Fastech.Ethernet.Transport.UdpFastechEthernetIoTransport.ThrowIfDisposed ( )

inlineprivate

이 전송 객체가 이미 해제되었으면 예외를 발생시킵니다.

예외

ObjectDisposedException 객체가 이미 해제된 경우 발생합니다.

UdpFastechEthernetIoTransport.cs 파일의 530 번째 라인에서 정의되었습니다.

    {
        ObjectDisposedException.ThrowIf(_disposed, this);
    }

다음을 참조함 : _disposed.

다음에 의해서 참조됨 : ConnectAsync(), SendAndReceiveAsync().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

멤버 데이터 문서화

◆ _disposed

bool Dreamine.IO.Fastech.Ethernet.Transport.UdpFastechEthernetIoTransport._disposed

private

disposed 값을 보관합니다.

UdpFastechEthernetIoTransport.cs 파일의 62 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : DisposeAsync(), ThrowIfDisposed().

◆ _options

readonly FastechEthernetIoOptions Dreamine.IO.Fastech.Ethernet.Transport.UdpFastechEthernetIoTransport._options

private

options 값을 보관합니다.

UdpFastechEthernetIoTransport.cs 파일의 35 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : ConnectAsync(), ResolveRemoteAddressAsync(), UdpFastechEthernetIoTransport().

◆ _remoteEndPoint

IPEndPoint? Dreamine.IO.Fastech.Ethernet.Transport.UdpFastechEthernetIoTransport._remoteEndPoint

private

remote End Point 값을 보관합니다.

UdpFastechEthernetIoTransport.cs 파일의 53 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : CloseCoreAsync(), ConnectAsync(), SendAndReceiveAsync().

◆ _syncLock

readonly SemaphoreSlim Dreamine.IO.Fastech.Ethernet.Transport.UdpFastechEthernetIoTransport._syncLock = new(1, 1)

private

sync Lock 값을 보관합니다.

UdpFastechEthernetIoTransport.cs 파일의 26 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : ConnectAsync(), DisconnectAsync(), DisposeAsync(), SendAndReceiveAsync().

◆ _udpClient

UdpClient? Dreamine.IO.Fastech.Ethernet.Transport.UdpFastechEthernetIoTransport._udpClient

private

udp Client 값을 보관합니다.

UdpFastechEthernetIoTransport.cs 파일의 44 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : CloseCoreAsync(), ConnectAsync(), SendAndReceiveAsync().

속성 문서화

◆ IsConnected

bool Dreamine.IO.Fastech.Ethernet.Transport.UdpFastechEthernetIoTransport.IsConnected

get

UDP 클라이언트가 생성되어 있는지 여부를 가져옵니다.

Dreamine.IO.Fastech.Ethernet.Transport.IFastechEthernetIoTransport를 구현.

UdpFastechEthernetIoTransport.cs 파일의 101 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : ConnectAsync().

◆ LastRequestFrame

byte [] Dreamine.IO.Fastech.Ethernet.Transport.UdpFastechEthernetIoTransport.LastRequestFrame = []

getprivate set

이 전송에서 마지막으로 보낸 요청 프레임을 가져옵니다.

UdpFastechEthernetIoTransport.cs 파일의 111 번째 라인에서 정의되었습니다.

111{ get; private set; } = [];

다음에 의해서 참조됨 : SendAndReceiveAsync().

◆ LastResponseFrame

byte [] Dreamine.IO.Fastech.Ethernet.Transport.UdpFastechEthernetIoTransport.LastResponseFrame = []

getprivate set

이 전송에서 마지막으로 받은 응답 프레임을 가져옵니다.

UdpFastechEthernetIoTransport.cs 파일의 121 번째 라인에서 정의되었습니다.

121{ get; private set; } = [];

다음에 의해서 참조됨 : SendAndReceiveAsync().

이 클래스에 대한 문서화 페이지는 다음의 파일로부터 생성되었습니다.:

UdpFastechEthernetIoTransport.cs

Public 멤버 함수

속성

Private 멤버 함수

정적 Private 멤버 함수

Private 속성

상세한 설명

생성자 & 소멸자 문서화

◆ UdpFastechEthernetIoTransport()

멤버 함수 문서화

◆ CloseCoreAsync()

◆ ConnectAsync()

◆ DisableUdpConnectionReset()

◆ DisconnectAsync()

◆ DisposeAsync()

◆ ResolveRemoteAddressAsync()

◆ SendAndReceiveAsync()

◆ ThrowIfDisposed()

멤버 데이터 문서화

◆ _disposed

◆ _options

◆ _remoteEndPoint

◆ _syncLock

◆ _udpClient

속성 문서화

◆ IsConnected

◆ LastRequestFrame

◆ LastResponseFrame