Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient에 대한 상속 다이어그램 :

Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient에 대한 협력 다이어그램:

[범례]

Public 멤버 함수
	MitsubishiMxComponentPlcClient (MitsubishiMxComponentOptions options)
	MitsubishiMxComponentPlcClient (MitsubishiMxComponentOptions options, IComObjectFactory factory)
override async ValueTask	DisposeAsync ()

Protected 멤버 함수
override Task< PlcResult >	ConnectCoreAsync (CancellationToken cancellationToken)
override Task< PlcResult >	DisconnectCoreAsync (CancellationToken cancellationToken)
override Task< PlcResult< bool[]> >	ReadBitsCoreAsync (PlcAddress address, int count, CancellationToken cancellationToken)
override Task< PlcResult< short[]> >	ReadWordsCoreAsync (PlcAddress address, int count, CancellationToken cancellationToken)
override Task< PlcResult >	WriteBitsCoreAsync (PlcAddress address, IReadOnlyList< bool > values, CancellationToken cancellationToken)
override Task< PlcResult >	WriteWordsCoreAsync (PlcAddress address, IReadOnlyList< short > values, CancellationToken cancellationToken)

속성
MitsubishiMxComponentOptions	Options `[get]`

Private 멤버 함수
Task< PlcResult< short[]> >	ReadWordsOneByOne (object component, PlcAddress address, int count, CancellationToken cancellationToken)
Task< PlcResult< bool[]> >	ReadBitsOneByOne (object component, PlcAddress address, int count, CancellationToken cancellationToken)
object	RequireComponent ()
void	ReleaseComponent ()

정적 Private 멤버 함수
static PlcResult	ToResult (int resultCode, string message)
static bool	TryExtractShortArray (object? source, int count, out short[] values)
static bool	TryExtractBoolArray (object? source, int count, out bool[] values)

Private 속성
readonly MitsubishiMxComponentOptions	_options
readonly IComObjectFactory	_factory
object?	_component

상세한 설명

Mitsubishi MX Component COM 인터페이스를 사용하는 PLC 클라이언트를 제공합니다.

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

생성자 & 소멸자 문서화

◆ MitsubishiMxComponentPlcClient() [1/2]

Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient.MitsubishiMxComponentPlcClient ( MitsubishiMxComponentOptions options )

inline

기본 COM 개체 팩터리를 사용해 MitsubishiMxComponentPlcClient 클래스의 새 인스턴스를 초기화합니다.

매개변수

options MX Component 연결 및 메서드 설정입니다.

예외

ArgumentNullException options 가 null일 때 발생합니다.

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

        : this(options, new DefaultComObjectFactory())
    {
    }

◆ MitsubishiMxComponentPlcClient() [2/2]

Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient.MitsubishiMxComponentPlcClient	(	MitsubishiMxComponentOptions	options,
		IComObjectFactory	factory )

inline

지정한 COM 개체 팩터리를 사용해 MitsubishiMxComponentPlcClient 클래스의 새 인스턴스를 초기화합니다.

매개변수

options	MX Component 연결 및 메서드 설정입니다.
factory	후기 바인딩 COM 개체를 생성할 팩터리입니다.

예외

ArgumentNullException options 또는 factory 가 null일 때 발생합니다.

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

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

다음을 참조함 : _factory, _options.

멤버 함수 문서화

◆ ConnectCoreAsync()

override Task< PlcResult > Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient.ConnectCoreAsync ( CancellationToken cancellationToken )

inlineprotected

COM 개체를 생성하고 논리 스테이션을 설정한 뒤 MX Component 연결을 엽니다.

매개변수

cancellationToken 연결 작업을 취소하는 토큰입니다.

반환값: MX Component 반환 코드를 포함하는 연결 결과 작업입니다.

예외

OperationCanceledException	취소 토큰이 취소된 경우 발생합니다.
PlatformNotSupportedException	기본 팩터리를 Windows가 아닌 플랫폼에서 사용할 때 발생합니다.
InvalidOperationException	COM 개체 생성이나 속성·메서드 호출이 실패할 때 발생할 수 있습니다.

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

    {
        cancellationToken.ThrowIfCancellationRequested();
 
        _component = _factory.Create(_options.ProgId);
        ComInvoker.SetProperty(_component, "ActLogicalStationNumber", _options.LogicalStationNumber);
 
        var resultCode = ComInvoker.ToReturnCode(ComInvoker.Invoke(_component, _options.OpenMethodName));
        return Task.FromResult(ToResult(resultCode, "MX Component open failed."));
    }

다음을 참조함 : _component, _factory, _options, ToResult().

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

◆ DisconnectCoreAsync()

override Task< PlcResult > Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient.DisconnectCoreAsync ( CancellationToken cancellationToken )

inlineprotected

MX Component 연결을 닫고 보유한 COM 개체를 해제합니다.

매개변수

cancellationToken 연결 해제 작업을 취소하는 토큰입니다.

반환값: MX Component 반환 코드를 포함하는 연결 해제 결과 작업입니다.

예외

OperationCanceledException	취소 토큰이 취소된 경우 발생합니다.
InvalidOperationException	COM 닫기 메서드 호출이 실패할 때 발생할 수 있습니다.

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

    {
        cancellationToken.ThrowIfCancellationRequested();
 
        if (_component is null)
        {
            return Task.FromResult(PlcResult.Success());
        }
 
        var resultCode = ComInvoker.ToReturnCode(ComInvoker.Invoke(_component, _options.CloseMethodName));
        ReleaseComponent();
        return Task.FromResult(ToResult(resultCode, "MX Component close failed."));
    }

다음을 참조함 : _component, _options, ReleaseComponent(), ToResult().

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

◆ DisposeAsync()

override async ValueTask Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient.DisposeAsync ( )

inline

기본 PLC 클라이언트 자원을 비동기로 정리하고 MX Component COM 개체를 해제합니다.

반환값: 비동기 정리 작업을 나타내는 값 작업입니다.

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

    {
        await base.DisposeAsync().ConfigureAwait(false);
        ReleaseComponent();
    }

다음을 참조함 : ReleaseComponent().

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

◆ ReadBitsCoreAsync()

override Task< PlcResult< bool[]> > Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient.ReadBitsCoreAsync	(	PlcAddress	address,
		int	count,
		CancellationToken	cancellationToken )

inlineprotected

연속된 PLC 비트 값을 읽으며 블록 호출이 호환되지 않으면 단건 호출로 전환합니다.

매개변수

address	읽기를 시작할 PLC 주소입니다.
count	읽을 비트 수입니다.
cancellationToken	읽기 작업을 취소하는 토큰입니다.

반환값: 읽은 비트 배열 또는 PLC 오류를 포함하는 결과 작업입니다.

예외

InvalidOperationException	클라이언트가 연결되지 않았거나 폴백 COM 호출이 실패할 때 발생합니다.
OperationCanceledException	취소 토큰이 취소된 경우 발생합니다.
NotSupportedException	PLC 장치 형식을 지원하지 않을 때 발생합니다.

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

    {
        var component = RequireComponent();
        var device = MitsubishiMxDeviceNameFormatter.Format(address);
        var buffer = new short[count];
        var args = new object?[] { device, count, buffer };
 
        try
        {
            cancellationToken.ThrowIfCancellationRequested();
 
            var resultCode = ComInvoker.ToReturnCode(ComInvoker.InvokeWithByRef(component, _options.ReadDeviceBlock2MethodName, args, 2));
            if (resultCode == 0 && TryExtractBoolArray(args[2], count, out var values))
            {
                return Task.FromResult(PlcResult<bool[]>.Success(values));
            }
        }
        catch (MissingMethodException)
        {
            // Fall back to GetDevice below for MX Component variants without block calls.
        }
        catch (COMException)
        {
            // COM late binding can reject array arguments. Fall back to GetDevice.
        }
        catch (InvalidOperationException ex) when (ex.InnerException is COMException)
        {
            // ComInvoker wraps COM target invocation failures. Fall back to GetDevice.
        }
 
        return ReadBitsOneByOne(component, address, count, cancellationToken);
    }

다음을 참조함 : _options, Dreamine.PLC.Mitsubishi.MxComponent.Devices.MitsubishiMxDeviceNameFormatter.Format(), ReadBitsOneByOne(), RequireComponent(), TryExtractBoolArray().

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

◆ ReadBitsOneByOne()

Task< PlcResult< bool[]> > Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient.ReadBitsOneByOne	(	object	component,
		PlcAddress	address,
		int	count,
		CancellationToken	cancellationToken )

inlineprivate

지정 범위의 PLC 비트를 단건 COM 호출로 읽습니다.

매개변수

component	연결된 MX Component COM 개체입니다.
address	시작 PLC 주소입니다.
count	읽을 비트 수입니다.
cancellationToken	반복 읽기를 취소하는 토큰입니다.

반환값: 비트 배열 또는 첫 번째 PLC 오류를 포함하는 결과 작업입니다.

예외

OperationCanceledException	취소 토큰이 취소된 경우 발생합니다.
FormatException	COM 값이 정수로 변환될 수 없을 때 발생할 수 있습니다.

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

    {
        var values = new bool[count];
 
        for (var index = 0; index < count; index++)
        {
            cancellationToken.ThrowIfCancellationRequested();
 
            var args = new object?[]
            {
                MitsubishiMxDeviceNameFormatter.FormatOffset(address, index),
                0
            };
 
            var resultCode = ComInvoker.ToReturnCode(ComInvoker.InvokeWithByRef(component, _options.ReadDeviceMethodName, args, 1));
            if (resultCode != 0)
            {
                return Task.FromResult(PlcResult<bool[]>.Failure($"MX Component bit read failed. code={resultCode}", resultCode));
            }
 
            values[index] = Convert.ToInt32(args[1], CultureInfo.InvariantCulture) != 0;
        }
 
        return Task.FromResult(PlcResult<bool[]>.Success(values));
    }

다음을 참조함 : _options, Dreamine.PLC.Mitsubishi.MxComponent.Devices.MitsubishiMxDeviceNameFormatter.FormatOffset().

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

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

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

◆ ReadWordsCoreAsync()

override Task< PlcResult< short[]> > Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient.ReadWordsCoreAsync	(	PlcAddress	address,
		int	count,
		CancellationToken	cancellationToken )

inlineprotected

연속된 PLC 워드 값을 읽으며 블록 호출이 호환되지 않으면 단건 호출로 전환합니다.

매개변수

address	읽기를 시작할 PLC 주소입니다.
count	읽을 워드 수입니다.
cancellationToken	읽기 작업을 취소하는 토큰입니다.

반환값: 읽은 워드 배열 또는 PLC 오류를 포함하는 결과 작업입니다.

예외

InvalidOperationException	클라이언트가 연결되지 않았거나 폴백 COM 호출이 실패할 때 발생합니다.
OperationCanceledException	취소 토큰이 취소된 경우 발생합니다.
OverflowException	COM 값이 short 범위를 벗어날 때 발생할 수 있습니다.

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

    {
        var component = RequireComponent();
        var device = MitsubishiMxDeviceNameFormatter.Format(address);
        var buffer = new short[count];
        var args = new object?[] { device, count, buffer };
 
        try
        {
            cancellationToken.ThrowIfCancellationRequested();
 
            var resultCode = ComInvoker.ToReturnCode(ComInvoker.InvokeWithByRef(component, _options.ReadDeviceBlock2MethodName, args, 2));
            if (resultCode == 0 && TryExtractShortArray(args[2], count, out var values))
            {
                return Task.FromResult(PlcResult<short[]>.Success(values));
            }
        }
        catch (MissingMethodException)
        {
            // Fall back to GetDevice below for MX Component variants that do not expose block calls through late binding.
        }
        catch (COMException)
        {
            // COM late binding can reject array arguments for ReadDeviceBlock2. Fall back to GetDevice.
        }
        catch (InvalidOperationException ex) when (ex.InnerException is COMException)
        {
            // ComInvoker wraps COM target invocation failures. Fall back to GetDevice for array type mismatches.
        }
 
        return ReadWordsOneByOne(component, address, count, cancellationToken);
    }

다음을 참조함 : _options, Dreamine.PLC.Mitsubishi.MxComponent.Devices.MitsubishiMxDeviceNameFormatter.Format(), ReadWordsOneByOne(), RequireComponent(), TryExtractShortArray().

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

◆ ReadWordsOneByOne()

Task< PlcResult< short[]> > Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient.ReadWordsOneByOne	(	object	component,
		PlcAddress	address,
		int	count,
		CancellationToken	cancellationToken )

inlineprivate

지정 범위의 PLC 워드를 단건 COM 호출로 읽습니다.

매개변수

component	연결된 MX Component COM 개체입니다.
address	시작 PLC 주소입니다.
count	읽을 워드 수입니다.
cancellationToken	반복 읽기를 취소하는 토큰입니다.

반환값: 워드 배열 또는 첫 번째 PLC 오류를 포함하는 결과 작업입니다.

예외

OperationCanceledException	취소 토큰이 취소된 경우 발생합니다.
OverflowException	COM 값이 short 범위를 벗어날 때 발생할 수 있습니다.

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

    {
        var values = new short[count];
 
        for (var index = 0; index < count; index++)
        {
            cancellationToken.ThrowIfCancellationRequested();
 
            var args = new object?[]
            {
                MitsubishiMxDeviceNameFormatter.FormatOffset(address, index),
                0
            };
 
            var resultCode = ComInvoker.ToReturnCode(ComInvoker.InvokeWithByRef(component, _options.ReadDeviceMethodName, args, 1));
            if (resultCode != 0)
            {
                return Task.FromResult(PlcResult<short[]>.Failure($"MX Component word read failed. code={resultCode}", resultCode));
            }
 
            values[index] = Convert.ToInt16(args[1], CultureInfo.InvariantCulture);
        }
 
        return Task.FromResult(PlcResult<short[]>.Success(values));
    }

다음을 참조함 : _options, Dreamine.PLC.Mitsubishi.MxComponent.Devices.MitsubishiMxDeviceNameFormatter.FormatOffset().

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

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

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

◆ ReleaseComponent()

void Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient.ReleaseComponent ( )

inlineprivate

보유한 MX Component COM 개체의 참조를 최종 해제하고 연결 상태를 초기화합니다.

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

    {
        if (_component is null)
        {
            return;
        }
 
        if (OperatingSystem.IsWindows() && Marshal.IsComObject(_component))
        {
            Marshal.FinalReleaseComObject(_component);
        }
 
        _component = null;
    }

다음을 참조함 : _component.

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

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

◆ RequireComponent()

object Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient.RequireComponent ( )

inlineprivate

현재 연결된 MX Component COM 개체를 반환합니다.

반환값: 연결된 COM 개체입니다.

예외

InvalidOperationException 클라이언트가 연결되지 않았을 때 발생합니다.

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

    {
        return _component ?? throw new InvalidOperationException("MX Component is not connected.");
    }

다음을 참조함 : _component.

다음에 의해서 참조됨 : ReadBitsCoreAsync(), ReadWordsCoreAsync(), WriteBitsCoreAsync(), WriteWordsCoreAsync().

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

◆ ToResult()

PlcResult Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient.ToResult	(	int	resultCode,
		string	message )

inlinestaticprivate

MX Component 반환 코드를 표준 PLC 결과로 변환합니다.

매개변수

resultCode	0이 성공인 MX Component 반환 코드입니다.
message	실패 결과에 포함할 작업 메시지입니다.

반환값: 성공 또는 코드와 메시지를 포함한 실패 결과입니다.

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

    {
        return resultCode == 0
            ? PlcResult.Success()
            : PlcResult.Failure($"{message} code={resultCode}", resultCode);
    }

다음에 의해서 참조됨 : ConnectCoreAsync(), DisconnectCoreAsync(), WriteBitsCoreAsync(), WriteWordsCoreAsync().

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

◆ TryExtractBoolArray()

bool Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient.TryExtractBoolArray	(	object?	source,
		int	count,
		out bool[]	values )

inlinestaticprivate

COM 배열 값을 지정한 길이의 부울 배열로 추출합니다.

매개변수

source	COM 호출이 반환한 배열 값입니다.
count	추출할 요소 수입니다.
values	변환 성공 시 추출된 비트 배열을 받습니다.

반환값: 지원되는 형식과 충분한 길이를 가진 배열이면 true, 아니면 false입니다.

예외

FormatException	배열 요소를 정수로 변환할 수 없을 때 발생할 수 있습니다.
OverflowException	배열 요소가 int 범위를 벗어날 때 발생할 수 있습니다.

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

    {
        values = new bool[count];
 
        switch (source)
        {
            case bool[] booleans when booleans.Length >= count:
                Array.Copy(booleans, values, count);
                return true;
            case short[] shorts when shorts.Length >= count:
                for (var index = 0; index < count; index++)
                {
                    values[index] = shorts[index] != 0;
                }
 
                return true;
            case int[] integers when integers.Length >= count:
                for (var index = 0; index < count; index++)
                {
                    values[index] = integers[index] != 0;
                }
 
                return true;
            case Array array when array.Length >= count:
                for (var index = 0; index < count; index++)
                {
                    values[index] = Convert.ToInt32(array.GetValue(index), CultureInfo.InvariantCulture) != 0;
                }
 
                return true;
            default:
                return false;
        }
    }

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

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

◆ TryExtractShortArray()

bool Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient.TryExtractShortArray	(	object?	source,
		int	count,
		out short[]	values )

inlinestaticprivate

COM 배열 값을 지정한 길이의 short 배열로 추출합니다.

매개변수

source	COM 호출이 반환한 배열 값입니다.
count	추출할 요소 수입니다.
values	변환 성공 시 추출된 워드 배열을 받습니다.

반환값: 지원되는 형식과 충분한 길이를 가진 배열이면 true, 아니면 false입니다.

예외

OverflowException 배열 요소가 short 범위를 벗어날 때 발생할 수 있습니다.

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

    {
        values = new short[count];
 
        switch (source)
        {
            case short[] shorts when shorts.Length >= count:
                Array.Copy(shorts, values, count);
                return true;
            case int[] integers when integers.Length >= count:
                for (var index = 0; index < count; index++)
                {
                    values[index] = Convert.ToInt16(integers[index], CultureInfo.InvariantCulture);
                }
 
                return true;
            case Array array when array.Length >= count:
                for (var index = 0; index < count; index++)
                {
                    values[index] = Convert.ToInt16(array.GetValue(index), CultureInfo.InvariantCulture);
                }
 
                return true;
            default:
                return false;
        }
    }

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

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

◆ WriteBitsCoreAsync()

override Task< PlcResult > Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient.WriteBitsCoreAsync	(	PlcAddress	address,
		IReadOnlyList< bool >	values,
		CancellationToken	cancellationToken )

inlineprotected

연속된 PLC 비트 값을 단건 MX Component 호출로 씁니다.

매개변수

address	쓰기를 시작할 PLC 주소입니다.
values	쓸 비트 값입니다.
cancellationToken	쓰기 작업을 취소하는 토큰입니다.

반환값: 첫 번째 실패 코드 또는 성공을 포함하는 쓰기 결과 작업입니다.

예외

InvalidOperationException	클라이언트가 연결되지 않았거나 COM 호출이 실패할 때 발생합니다.
OperationCanceledException	취소 토큰이 취소된 경우 발생합니다.

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

    {
        var component = RequireComponent();
 
        for (var index = 0; index < values.Count; index++)
        {
            cancellationToken.ThrowIfCancellationRequested();
 
            var resultCode = ComInvoker.ToReturnCode(ComInvoker.Invoke(
                component,
                _options.WriteDeviceMethodName,
                MitsubishiMxDeviceNameFormatter.FormatOffset(address, index),
                values[index] ? 1 : 0));
 
            if (resultCode != 0)
            {
                return Task.FromResult(ToResult(resultCode, "MX Component bit write failed."));
            }
        }
 
        return Task.FromResult(PlcResult.Success());
    }

다음을 참조함 : _options, Dreamine.PLC.Mitsubishi.MxComponent.Devices.MitsubishiMxDeviceNameFormatter.FormatOffset(), RequireComponent(), ToResult().

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

◆ WriteWordsCoreAsync()

override Task< PlcResult > Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient.WriteWordsCoreAsync	(	PlcAddress	address,
		IReadOnlyList< short >	values,
		CancellationToken	cancellationToken )

inlineprotected

연속된 PLC 워드 값을 쓰며 블록 호출이 호환되지 않으면 단건 호출로 전환합니다.

매개변수

address	쓰기를 시작할 PLC 주소입니다.
values	쓸 워드 값입니다.
cancellationToken	쓰기 작업을 취소하는 토큰입니다.

반환값: 첫 번째 실패 코드 또는 성공을 포함하는 쓰기 결과 작업입니다.

예외

InvalidOperationException	클라이언트가 연결되지 않았거나 폴백 COM 호출이 실패할 때 발생합니다.
OperationCanceledException	취소 토큰이 취소된 경우 발생합니다.

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

    {
        var component = RequireComponent();
        var device = MitsubishiMxDeviceNameFormatter.Format(address);
        var data = values.ToArray();
 
        try
        {
            cancellationToken.ThrowIfCancellationRequested();
 
            var resultCode = ComInvoker.ToReturnCode(ComInvoker.InvokeWithByRef(
                component,
                _options.WriteDeviceBlock2MethodName,
                [device, values.Count, data],
                2));
 
            if (resultCode == 0)
            {
                return Task.FromResult(PlcResult.Success());
            }
        }
        catch (MissingMethodException)
        {
            // Fall back to SetDevice below.
        }
        catch (COMException)
        {
            // COM late binding can reject array arguments for WriteDeviceBlock2. Fall back to SetDevice.
        }
        catch (InvalidOperationException ex) when (ex.InnerException is COMException)
        {
            // ComInvoker wraps COM target invocation failures. Fall back to SetDevice for array type mismatches.
        }
 
        for (var index = 0; index < values.Count; index++)
        {
            cancellationToken.ThrowIfCancellationRequested();
 
            var resultCode = ComInvoker.ToReturnCode(ComInvoker.Invoke(
                component,
                _options.WriteDeviceMethodName,
                MitsubishiMxDeviceNameFormatter.FormatOffset(address, index),
                values[index]));
 
            if (resultCode != 0)
            {
                return Task.FromResult(ToResult(resultCode, "MX Component word write failed."));
            }
        }
 
        return Task.FromResult(PlcResult.Success());
    }

다음을 참조함 : _options, Dreamine.PLC.Mitsubishi.MxComponent.Devices.MitsubishiMxDeviceNameFormatter.Format(), Dreamine.PLC.Mitsubishi.MxComponent.Devices.MitsubishiMxDeviceNameFormatter.FormatOffset(), RequireComponent(), ToResult().

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

멤버 데이터 문서화

◆ _component

object? Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient._component

private

component 값을 보관합니다.

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

다음에 의해서 참조됨 : ConnectCoreAsync(), DisconnectCoreAsync(), ReleaseComponent(), RequireComponent().

◆ _factory

readonly IComObjectFactory Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient._factory

private

factory 값을 보관합니다.

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

다음에 의해서 참조됨 : ConnectCoreAsync(), MitsubishiMxComponentPlcClient().

◆ _options

readonly MitsubishiMxComponentOptions Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient._options

private

options 값을 보관합니다.

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

다음에 의해서 참조됨 : ConnectCoreAsync(), DisconnectCoreAsync(), MitsubishiMxComponentPlcClient(), ReadBitsCoreAsync(), ReadBitsOneByOne(), ReadWordsCoreAsync(), ReadWordsOneByOne(), WriteBitsCoreAsync(), WriteWordsCoreAsync().

속성 문서화

◆ Options

MitsubishiMxComponentOptions Dreamine.PLC.Mitsubishi.MxComponent.Clients.MitsubishiMxComponentPlcClient.Options

get

이 클라이언트가 사용하는 MX Component 옵션을 가져옵니다.

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

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

MitsubishiMxComponentPlcClient.cs

Public 멤버 함수

Protected 멤버 함수

속성

Private 멤버 함수

정적 Private 멤버 함수

Private 속성

상세한 설명

생성자 & 소멸자 문서화

◆ MitsubishiMxComponentPlcClient() [1/2]

◆ MitsubishiMxComponentPlcClient() [2/2]

멤버 함수 문서화

◆ ConnectCoreAsync()

◆ DisconnectCoreAsync()

◆ DisposeAsync()

◆ ReadBitsCoreAsync()

◆ ReadBitsOneByOne()

◆ ReadWordsCoreAsync()

◆ ReadWordsOneByOne()

◆ ReleaseComponent()

◆ RequireComponent()

◆ ToResult()

◆ TryExtractBoolArray()

◆ TryExtractShortArray()

◆ WriteBitsCoreAsync()

◆ WriteWordsCoreAsync()

멤버 데이터 문서화

◆ _component

◆ _factory

◆ _options

속성 문서화

◆ Options