KeyValuePair 커넥터 메서드

추가

키값 쌍을 추가합니다.

매개변수에 입력을 제공하려면 다음 문서를 참조하십시오 포트 속성 구성.

표 1. 메서드 매개변수 추가
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
키	키의 이름입니다.	의 데이터	문자열	안 함	예
값	키의 값입니다.	의 데이터	객체	안 함	예
중복 무시	값이 True이면 메서드는 중복 키를 무시합니다. 그렇지 않고 값이 False이면 메서드는 오류 메시지를 반환합니다.	의 데이터	부울	안 함	아니요

지우기

모든 키값 쌍을 지웁니다.

ContainsKey

지정된 키가 존재하면 예를 반환하고, 그렇지 않으면 아니오를 반환합니다.

매개변수에 입력을 제공하려면 다음 문서를 참조하십시오 포트 속성 구성.

표 2. ContainsKey 메서드 매개변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
키	키의 이름입니다.	의 데이터	문자열	안 함	예
돌아가기	지정된 키가 존재하면 예를 반환하고, 그렇지 않으면 아니오를 반환합니다.	데이터 출력	부울	해당 사항 없음	해당 사항 없음

값 포함

지정된 키 값이 있으면 예를 반환하고, 그렇지 않으면 아니오를 반환합니다.

매개변수에 입력을 제공하려면 다음 문서를 참조하십시오 포트 속성 구성.

표 3. ContainsValue 메서드 매개변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
값	키 값의 이름입니다.	의 데이터	문자열	안 함	예
돌아가기	지정된 키 값이 있으면 예를 반환하고, 그렇지 않으면 아니오를 반환합니다.	데이터 출력	부울	해당 사항 없음	해당 사항 없음

카운트

키값 쌍의 총 수를 반환합니다.

표 4. 카운트 메서드 매개변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
돌아가기	키값 쌍의 총 수를 반환합니다.	데이터 출력	정수	해당 사항 없음	해당 사항 없음

삭제

지정된 키를 제거합니다.

매개변수에 입력을 제공하려면 다음 문서를 참조하십시오 포트 속성 구성.

표 5. 메서드 매개변수 삭제
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
키	키의 이름입니다.	의 데이터	문자열	안 함	예

항목 받기

지정된 키의 값을 반환합니다.

매개변수에 입력을 제공하려면 다음 문서를 참조하십시오 포트 속성 구성.

표 6. GetItem 메서드 매개변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
키	키의 이름입니다.	의 데이터	문자열	안 함	예
돌아가기	키 값을 반환합니다.	데이터 출력	객체	해당 사항 없음	해당 사항 없음

GetItems

여러 키의 값을 반환합니다. 먼저 메서드에서 키를 구성해야 합니다.

구성하려면 다음 단계를 수행합니다.

방법 설정 아이콘( )을 클릭합니다.
키 추가 아이콘( )을 클릭합니다.
키 이름을 입력합니다.
목록에서 키 데이터 유형을 업데이트합니다.
여러 키 이름을 설정하려면 단계를 반복합니다.
확인을 클릭합니다.
설정한 각 키 이름으로 데이터 출력 포트가 생성됩니다.

표 7. GetItems 메서드 매개변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
키	키 값을 반환합니다.	데이터 출력	객체	해당 사항 없음	해당 사항 없음

GetItemsByIndex

인덱스를 기반으로 키 값을 반환합니다. 먼저 메서드에서 인덱스를 구성해야 합니다.

구성하려면 다음 단계를 수행합니다.

방법 설정 아이콘( )을 클릭합니다.
인덱스 추가 아이콘( )을 클릭합니다.
키 인덱스를 입력합니다.
목록에서 키 데이터 유형을 업데이트합니다.
여러 키 인덱스를 설정하려면 단계를 반복합니다.
확인을 클릭합니다.
데이터 출력 포트는 설정한 각 키 인덱스를 사용하여 생성됩니다.

표 8. GetItemsByIndex 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
키 인덱스	키 값을 반환합니다.	데이터 출력	객체	해당 사항 없음	해당 사항 없음

ParseFromText

지정된 텍스트를 키 값 쌍으로 구문 분석합니다. 여러 keyvalue 쌍을 만들 수 있습니다.

매개변수에 입력을 제공하려면 다음 문서를 참조하십시오 포트 속성 구성.

표 9. ParseFromText 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
텍스트	메서드가 구문 분석하는 키와 값으로 구성된 텍스트입니다.	의 데이터	문자열	안 함	예
항목 구분 기호	두 키값 쌍 사이의 구분 기호입니다.	의 데이터	문자열	안 함	예
키값분리기	키와 값 사이의 구분 기호입니다.	의 데이터	문자열	안 함	예
ClearBeforeParse	True인 경우 구문 분석하기 전에 기존 키 값 쌍을 지웁니다.	의 데이터	부울	안 함	아니요

반전

키 인덱스를 되돌립니다.

팁:

메서드를 실행한 후 GetItemsByIndex 메서드를 실행하여 출력을 볼 수 있습니다.

데이터 설정

정보가 필요합니다.

SetItem

키 값을 업데이트합니다.

매개변수에 입력을 제공하려면 다음 문서를 참조하십시오 포트 속성 구성.

표 10. SetItem 메서드 매개변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
키	키의 이름입니다.	의 데이터	문자열	안 함	예
값	키의 업데이트된 값입니다.	의 데이터	객체	안 함	예

팁:

GetItemsByIndex 메서드를 실행하여 업데이트된 값을 테스트합니다.

SetItems

지정된 키의 값을 업데이트합니다. 먼저 메서드에서 키를 구성해야 합니다.

키를 구성하려면 다음 단계를 수행합니다.

방법 설정 아이콘( )을 클릭합니다.
키 추가 아이콘( )을 클릭합니다.
키 이름을 입력합니다.
목록에서 키 데이터 유형을 업데이트합니다.
여러 키 이름을 설정하려면 단계를 반복합니다.
확인을 클릭합니다.
데이터 입력 포트는 설정한 각 키 이름으로 생성됩니다.

매개변수에 입력을 제공하려면 다음 문서를 참조하십시오 포트 속성 구성.

표 11. SetItems 메서드 매개변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
키	키의 업데이트된 값입니다.	의 데이터	객체	안 함	예

팁:

GetItemsByIndex 메서드를 실행하여 업데이트된 값을 테스트합니다.

SetItemsByIndex

지정된 인덱스를 기반으로 키 값을 업데이트합니다. 먼저 메서드에서 인덱스를 구성해야 합니다.

인덱스를 구성하려면 다음 단계를 수행합니다.

방법 설정 아이콘( )을 클릭합니다.
인덱스 추가 아이콘( )을 클릭합니다.
키 인덱스를 입력합니다.
목록에서 키 데이터 유형을 업데이트합니다.
여러 키 인덱스를 설정하려면 단계를 반복합니다.
확인을 클릭합니다.
데이터 입력 포트는 설정한 각 키 인덱스를 사용하여 생성됩니다.

표 12. SetItemsByIndex 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
키 인덱스	키의 인덱스입니다.	의 데이터	객체	안 함	예

팁:

GetItemsByIndex 메서드를 실행하여 업데이트된 값을 테스트합니다.

ToJSON

키 값 쌍을 JSON 형식으로 렌더링합니다.

ToText

키값 쌍을 텍스트 형식으로 렌더링합니다.

매개변수에 입력을 제공하려면 다음 문서를 참조하십시오 포트 속성 구성.

표 13. ToText 메서드 매개변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
값만	True이면 메서드는 키 값만 렌더링하고, 그렇지 않으면 keyvalue 쌍을 렌더링합니다.	의 데이터	부울	안 함	아니요
돌아가기	키값 쌍을 텍스트 형식으로 반환합니다.	데이터 출력	문자열	해당 사항 없음	해당 사항 없음